Retrieving Deal Details - Useme API docs

After creating a deal, your integration can retrieve its current state from Useme.

This is useful when you want to synchronize your system with Useme, show the user the latest deal progress, or continue the flow after the deal has been created. The retrieved data includes the current public deal status, payment token, contractor assignment, stage identifier, currency, and billing summary.

A common flow looks like this:

Create a contractor.

Create a deal using your own partner_id.

Store the returned Useme deal id.

Retrieve the deal when you need the latest status or payment information.

Use the returned stage_id when uploading work files.

The retrieve endpoint only returns deals owned by the authenticated employer account. If a deal belongs to another account or does not exist, it is treated as not found.

For the full request and response schema, see the Retrieve deal details endpoint reference.