ONonlink
Partner API

Read a USDT send

get/v1/usdt/sends/{id}

Request

  • Base URL
    https://sandbox.onlink.africa
  • Auth
    API key in header X-OnLink-Key

Path parameters

idstring required

Response

The send.

idstring required

The send id.

status'awaiting_confirmation' | 'confirmed' | 'processing' | 'settled' | 'failed' | 'expired' required

The send status.

destinationWalletIdstring required

The destination wallet id you registered.

usdtAmountstring required

The amount sent, in USDT.

partnerReferencestring

Your own reference, echoed back.

failureReasonstring

A classified failure code, present only once failed.

createdAtstring date-time required

ISO-8601 instant the send was created.

confirmedAtstring date-time

ISO-8601 instant the send was confirmed: when its confirmation code was verified, or, when confirmation is waived for your account, when the send was created already confirmed.

Example response

{
  "id": "ed9f1e6a-0000-4000-8000-000000000040",
  "status": "awaiting_confirmation",
  "destinationWalletId": "fa9f1e6a-0000-4000-8000-000000000050",
  "usdtAmount": "25.500000",
  "partnerReference": "ACME-SEND-000123",
  "failureReason": "USDT_SEND_INSUFFICIENT_LEDGER_BALANCE",
  "createdAt": "2026-09-16T00:00:00.000Z",
  "confirmedAt": "2026-09-16T00:02:00.000Z",
  "confirmation": {
    "id": "df9f1e6a-0000-4000-8000-000000000030",
    "channel": "email",
    "deliveredTo": "o***@partner.co.ke",
    "expiresAt": "2026-09-11T00:15:00.000Z",
    "resendAvailableAt": "2026-09-11T00:00:15.000Z",
    "webhookDelivery": {
      "status": "delivered",
      "attempts": 1,
      "lastAttemptAt": "2026-09-11T00:00:02.000Z"
    },
    "waiverNotApplied": "key_without_ip_allowlist"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.