List Payout Requests

curl https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011/release-requests \
  -H "Authorization: Bearer sk_live_your_api_key_here"

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

const data = await response.json();

{
  "releaseRequests": [
    {
      "requestId": "timesheet-2026-W10",
      "reference": "Week 10 (Mar 2-8)",
      "amountTnd": 67.61,
      "amountFace": 24,
      "currency": "USD",
      "status": "released",
      "createdVia": "api",
      "approvalDeadline": "2026-03-11T09:00:00Z",
      "sellerNetTnd": 63.55,
      "decidedAt": "2026-03-10T14:22:00Z",
      "decisionSource": "buyer",
      "releasedAt": "2026-03-10T14:22:01Z",
      "createdAt": "2026-03-09T09:00:00Z"
    },
    {
      "requestId": "timesheet-2026-W12",
      "reference": "Week 12 (Mar 16-22)",
      "amountTnd": 67.61,
      "amountFace": 24,
      "currency": "USD",
      "status": "disputed",
      "createdVia": "api",
      "approvalDeadline": "2026-03-25T09:00:00Z",
      "decidedAt": "2026-03-24T11:05:00Z",
      "decisionSource": "buyer",
      "disputeTicketId": "6612f1a8bcf86cd7994390aa",
      "createdAt": "2026-03-23T09:00:00Z"
    }
  ],
  "progressiveRelease": {
    "enabled": true,
    "autoApproveHours": 48,
    "minReleaseTnd": 5,
    "buyerConsentAcceptedAt": "2026-03-01T10:00:00Z"
  },
  "availableForRelease": 272,
  "reserved": 24,
  "releasedTotal": 24,
  "reservedTnd": 67.61,
  "availableForReleaseTnd": 766.23,
  "releasedTotalTnd": 67.61,
  "fundedAmount": 320,
  "fundedAmountTnd": 901.45,
  "remainingAmount": 296,
  "remainingAmountTnd": 833.84,
  "refundedTotal": 0,
  "refundedTotalTnd": 0,
  "escrowStatus": "paid"
}

Return every payout request on a progressive-release escrow, with each period’s status, deadline and admin resolution. The response also carries the live face + TND reservation figures (and fundedAmount* / remainingAmount* / refundedTotal*), so you can size the next period and reconcile without inventing FX. Use this to reconcile your own timesheet records — for example after a webhook delivery failure, or when rebuilding state on a scheduled job.

curl https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011/release-requests \
  -H "Authorization: Bearer sk_live_your_api_key_here"

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

const data = await response.json();

{
  "releaseRequests": [
    {
      "requestId": "timesheet-2026-W10",
      "reference": "Week 10 (Mar 2-8)",
      "amountTnd": 67.61,
      "amountFace": 24,
      "currency": "USD",
      "status": "released",
      "createdVia": "api",
      "approvalDeadline": "2026-03-11T09:00:00Z",
      "sellerNetTnd": 63.55,
      "decidedAt": "2026-03-10T14:22:00Z",
      "decisionSource": "buyer",
      "releasedAt": "2026-03-10T14:22:01Z",
      "createdAt": "2026-03-09T09:00:00Z"
    },
    {
      "requestId": "timesheet-2026-W12",
      "reference": "Week 12 (Mar 16-22)",
      "amountTnd": 67.61,
      "amountFace": 24,
      "currency": "USD",
      "status": "disputed",
      "createdVia": "api",
      "approvalDeadline": "2026-03-25T09:00:00Z",
      "decidedAt": "2026-03-24T11:05:00Z",
      "decisionSource": "buyer",
      "disputeTicketId": "6612f1a8bcf86cd7994390aa",
      "createdAt": "2026-03-23T09:00:00Z"
    }
  ],
  "progressiveRelease": {
    "enabled": true,
    "autoApproveHours": 48,
    "minReleaseTnd": 5,
    "buyerConsentAcceptedAt": "2026-03-01T10:00:00Z"
  },
  "availableForRelease": 272,
  "reserved": 24,
  "releasedTotal": 24,
  "reservedTnd": 67.61,
  "availableForReleaseTnd": 766.23,
  "releasedTotalTnd": 67.61,
  "fundedAmount": 320,
  "fundedAmountTnd": 901.45,
  "remainingAmount": 296,
  "remainingAmountTnd": 833.84,
  "refundedTotal": 0,
  "refundedTotalTnd": 0,
  "escrowStatus": "paid"
}

Path Parameters

string

required

Escrow ID

Response Fields

Error Responses

401 Unauthorized

{
  "error": "Unauthorized"
}

403 Forbidden

{
  "error": "Forbidden",
  "message": "Only a party on this escrow can manage payout requests"
}

404 Not Found

{
  "error": "Escrow not found"
}

A non-progressive escrow returns an empty releaseRequests array with progressiveRelease: null, rather than an error.

Get Started

API Reference

Guides

Developer Portal

Path Parameters

Response Fields

Error Responses

401 Unauthorized

403 Forbidden

404 Not Found

​Path Parameters

​Response Fields

​Error Responses

​401 Unauthorized

​403 Forbidden

​404 Not Found

Path Parameters

Response Fields

Error Responses

401 Unauthorized

403 Forbidden

404 Not Found