Get Contract

curl -X GET https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011/contract \
  -H "Authorization: Bearer sk_live_your_api_key_here"

const response = await fetch('https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011/contract', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_live_your_api_key_here'
  }
});

const data = await response.json();

{
  "contract": {
    "id": "507f1f77bcf86cd799439012",
    "escrow": "507f1f77bcf86cd799439011",
    "terms": "The seller agrees to deliver a fully functional website within 7 days. The buyer agrees to pay the amount upon completion.",
    "language": "en",
    "pdfUrl": "https://dhmad.tn/contracts/507f1f77bcf86cd799439012.pdf",
    "sellerSignature": {
      "signedAt": "2024-01-15T10:30:00Z",
      "signatureImage": "data:image/png;base64,..."
    },
    "buyerSignature": {
      "signedAt": "2024-01-16T14:00:00Z",
      "signatureImage": "data:image/png;base64,..."
    },
    "isFullySigned": true,
    "pdfVersions": [
      {
        "type": "fully-signed",
        "url": "https://cdn.dhmad.tn/contracts/507f1f77bcf86cd799439012/1705406400000.pdf",
        "mimeType": "application/pdf",
        "createdAt": "2024-01-16T14:00:00Z"
      }
    ],
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-16T14:00:00Z"
  }
}

curl -X GET https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011/contract \
  -H "Authorization: Bearer sk_live_your_api_key_here"

const response = await fetch('https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011/contract', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_live_your_api_key_here'
  }
});

const data = await response.json();

{
  "contract": {
    "id": "507f1f77bcf86cd799439012",
    "escrow": "507f1f77bcf86cd799439011",
    "terms": "The seller agrees to deliver a fully functional website within 7 days. The buyer agrees to pay the amount upon completion.",
    "language": "en",
    "pdfUrl": "https://dhmad.tn/contracts/507f1f77bcf86cd799439012.pdf",
    "sellerSignature": {
      "signedAt": "2024-01-15T10:30:00Z",
      "signatureImage": "data:image/png;base64,..."
    },
    "buyerSignature": {
      "signedAt": "2024-01-16T14:00:00Z",
      "signatureImage": "data:image/png;base64,..."
    },
    "isFullySigned": true,
    "pdfVersions": [
      {
        "type": "fully-signed",
        "url": "https://cdn.dhmad.tn/contracts/507f1f77bcf86cd799439012/1705406400000.pdf",
        "mimeType": "application/pdf",
        "createdAt": "2024-01-16T14:00:00Z"
      }
    ],
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-16T14:00:00Z"
  }
}

Retrieve the contract details and PDF URL for a specific escrow transaction. Only standard mode escrows have a contract — for quick escrows this endpoint returns 404. A charge id returns 409 CHARGE_NOT_AN_ESCROW. You must be the seller or buyer of the escrow to access the contract. The response includes the contract terms, signing status, and a presigned URL to download the contract PDF.

curl -X GET https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011/contract \
  -H "Authorization: Bearer sk_live_your_api_key_here"

const response = await fetch('https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011/contract', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_live_your_api_key_here'
  }
});

const data = await response.json();

{
  "contract": {
    "id": "507f1f77bcf86cd799439012",
    "escrow": "507f1f77bcf86cd799439011",
    "terms": "The seller agrees to deliver a fully functional website within 7 days. The buyer agrees to pay the amount upon completion.",
    "language": "en",
    "pdfUrl": "https://dhmad.tn/contracts/507f1f77bcf86cd799439012.pdf",
    "sellerSignature": {
      "signedAt": "2024-01-15T10:30:00Z",
      "signatureImage": "data:image/png;base64,..."
    },
    "buyerSignature": {
      "signedAt": "2024-01-16T14:00:00Z",
      "signatureImage": "data:image/png;base64,..."
    },
    "isFullySigned": true,
    "pdfVersions": [
      {
        "type": "fully-signed",
        "url": "https://cdn.dhmad.tn/contracts/507f1f77bcf86cd799439012/1705406400000.pdf",
        "mimeType": "application/pdf",
        "createdAt": "2024-01-16T14:00:00Z"
      }
    ],
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-16T14:00:00Z"
  }
}

Path Parameters

string

required

Escrow ID

Response Fields

Error Responses

401 Unauthorized

{
  "error": "Unauthorized"
}

403 Forbidden

No Associated User Account

{
  "error": "Forbidden",
  "message": "Developer account must be associated with a user account. Please associate your account in the developer dashboard."
}

Not Your Escrow

{
  "error": "Forbidden",
  "message": "You do not have access to this escrow. You can only view escrows where you are the seller or buyer."
}

404 Not Found

Escrow Not Found

{
  "error": "Escrow not found"
}

Contract Not Found

{
  "error": "Contract not found for this escrow"
}

409 Conflict

{
  "error": "Conflict",
  "code": "CHARGE_NOT_AN_ESCROW",
  "message": "This id is a charge. Use the /v1/charges endpoints."
}

Authenticate using your API key via the Authorization: Bearer sk_live_... header or the X-API-Key: sk_live_... header.

Get Started

API Reference

Guides

Developer Portal

Path Parameters

Response Fields

Error Responses

401 Unauthorized

403 Forbidden

404 Not Found

409 Conflict

​Path Parameters

​Response Fields

​Error Responses

​401 Unauthorized

​403 Forbidden

​404 Not Found

​409 Conflict

Path Parameters

Response Fields

Error Responses

401 Unauthorized

403 Forbidden

404 Not Found

409 Conflict