1. Deals
Useme API docs
v2.0
  • v1.0
  • v2.0
  • Guides
    • Introduction
    • Getting Startted
    • Creating and Tracking Deals
  • Reference
    • Categories
      • List category tree
    • Deals
      • Create a new deal
        POST
      • Retrieve deal details
        GET
      • List employer deals
        GET
  • Schemas
    • APIDealBilling
    • APIDealContractorPayment
    • APIDealEmployerPayment
    • APIV2RetrieveDealResponse
    • CategoryTree
    • CopyrightTransferEnum
    • CreateDeal
    • DealListItem
    • FreelancerLanguageEnum
    • FreelancerStatusEnum
    • NullEnum
    • StatusEnum
    • SubCategory
    • V2CategoriesListSuccessResponse
    • V2DealBadRequestResponse
    • V2DealConflictResponse
    • V2DealCreateData
    • V2DealCreateSuccessResponse
    • V2ListDealsSuccessResponse
    • V2PaginatedDealList
    • V2RetrieveDealNotFoundResponse
    • V2RetrieveDealServerErrorResponse
    • V2RetrieveDealSuccessResponse
  1. Deals

Retrieve deal details

GET
https://sandbox.useme.com/api/2.0/deal/{payment_token}/
Returns full details of a single deal owned by the authenticated employer, identified by its payment token. Includes current status, signed date, currency, and billing breakdown for both sides.

Request

Authorization
or
Path Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://sandbox.useme.com/api/2.0/deal//' \
--header 'Authorization: Token <here-paste-your-token>'

Responses

🟢200
application/json
The deal details were successfully retrieved.
Bodyapplication/json

Example
{
    "data": {
        "contractor_email": "contractor@email.com",
        "partner_id": "partner-deal-2001",
        "status": "created",
        "payment_token": "UMCSDVCX",
        "currency": "EUR",
        "signed_date": "2024-03-20",
        "billing": {
            "commission": "120.00",
            "employer": {
                "net_amount": "1000.00",
                "vat_amount": "230.00",
                "gross_amount": "1230.00"
            },
            "freelancer": {
                "net_amount": "850.00",
                "vat_amount": "0.00",
                "pit_advance": "0.00",
                "gross_amount": "850.00"
            }
        }
    }
}
🟠404
🔴500
Modified at 2026-07-27 12:18:25
Previous
Create a new deal
Next
List employer deals
Built with