Transfer drafts

Get a transfer draft approval record

Changed on

Returns the platform approval status for a registered MCP transfer draft owned by the caller organization.

get/v1/transfer-drafts/{draftId}

Request

Path parameters

draftIdstring required
Example:tdraft_0123456789abcdef01234567

Headers

X-API-Keystring

API key

Response

Transfer draft approval retrieved

idstring required
draftIdstring required
customerIdstring required
draftHashstring required
destinationAccountIdsstring[] required

Payee account ids bound at registration and screened at approve.

status'PENDING_APPROVAL' | 'SCREENING' | 'APPROVED' | 'REJECTED' required
createdAtstring date-time required
updatedAtstring date-time required

Example response

{
  "id": "tda_abc123",
  "draftId": "tdraft_0123456789abcdef01234567",
  "customerId": "cus_abc123",
  "draftHash": "a1b2c3d4e5f6789012345678abcdef01",
  "destinationAccountIds": [
    "eba_payee1"
  ],
  "status": "PENDING_APPROVAL"
}

Changes

    • warning

      added the new SCREENING enum value to the response property for the response status

    • info

      added the required property to the response with the status

    • info

      endpoint added