v1

latestOpenAPI 3.0.02026-07-24103118224.7 KB

Connect Transfers

Get an internal Connect transfer

Returns a single transfer by id. 404s if the transfer was not initiated by the authenticated marketplace.

get/api/connect/transfers/{transferId}

Path parameters

transferIdstring required

Response

Transfer details

idstring required

marketplaceUserIdstring required

originUserIdstring required

destinationUserIdstring required

amountInCentsnumber required

currency'USDC' | 'EURC' required

status'INITIATED' | 'PROCESSING' | 'CONFIRMED' | 'FAILED' required

CONFIRMED is terminal-success. PROCESSING means the on-chain transfer was submitted and is awaiting confirmation (Bridge origins). FAILED is terminal-failure.

provider'privy' | 'bridge' required

referencestring nullable

txHashstring nullable

failReasonstring nullable

descriptionstring nullable

metadataobject nullable

createdAtstring date-time required

updatedAtstring date-time required

Example response

{
  "id": "clz0marketplacetransferid",
  "marketplaceUserId": "usr_marketplace",
  "originUserId": "usr_origin",
  "destinationUserId": "usr_destination",
  "amountInCents": 5000,
  "currency": "USDC",
  "status": "PROCESSING",
  "provider": "privy",
  "reference": "mkttransfer_clz0marketplacetransferid",
  "txHash": "0xabc...",
  "failReason": "ERROR",
  "description": "Weekly payout to seller Alpha",
  "createdAt": "2026-06-12T12:00:00.000Z",
  "updatedAt": "2026-06-12T12:00:05.000Z"
}