Get transaction confirmation status

{
  "transaction": {
    "preparationId": "preparation_markPaid",
    "purpose": "markPaid",
    "status": "CONFIRMED",
    "transactionHash": "0xabababababababababababababababababababababababababababababababab",
    "confirmations": 2,
    "requiredConfirmations": 2
  },
  "trade": {
    "availableActions": [
      "openDispute"
    ],
    "chainId": 80002,
    "counterparty": {
      "displayName": "Alex",
      "partnerName": "Example Partner"
    },
    "createdAt": "2026-10-23T10:00:00.000Z",
    "displayLabel": "Bank transfer",
    "escrowAddress": "0x3333333333333333333333333333333333333333",
    "escrowId": "42",
    "fiatCurrencyId": "usd",
    "fundedAt": "2026-10-23T10:00:00.000Z",
    "id": "trade_demo",
    "merchant": {
      "avatarUrl": "",
      "fullName": "Example Merchant",
      "userId": "merchant_demo",
      "username": "example"
    },
    "merchantRateDetails": {
      "MarketRate": {
        "type": "fiat",
        "value": 1
      },
      "MerchantMargin": {
        "type": "percentage",
        "value": 0
      },
      "MerchantRate": {
        "type": "fiat",
        "value": 1
      }
    },
    "paymentInstructions": {
      "data": {
        "accountName": "Example Merchant",
        "accountNumber": "EXAMPLE123456"
      },
      "displayLabel": "Bank transfer",
      "paymentMethodId": "bank_transfer"
    },
    "paymentMethodId": "bank_transfer",
    "pricing": {
      "customerFeeFiat": "0",
      "customerFiatAmount": "100",
      "lockAmountUsdt": "100",
      "makerFeeUsdt": "0",
      "merchantRateFiat": "1",
      "partnerFeeFiat": "0",
      "partnerFeeUsdt": "0",
      "platformFeeFiat": "0",
      "platformFeeUsdt": "0",
      "recipientAmountUsdt": "100",
      "refundAmountUsdt": "100",
      "subtotalFiat": "100",
      "usdtAmount": "100"
    },
    "senderDetails": null,
    "settlementOutcome": null,
    "side": "BUY",
    "source": "partner",
    "status": "PAID",
    "tokenAddress": "0x4444444444444444444444444444444444444444",
    "tradeDetails": {
      "Amount": {
        "type": "crypto",
        "value": 100
      },
      "MerchantRate": {
        "type": "fiat",
        "value": 1
      },
      "ServiceFee": {
        "type": "fiat",
        "value": 0
      },
      "Subtotal": {
        "type": "fiat",
        "value": 100
      },
      "YouPay": {
        "type": "fiat",
        "value": 100
      }
    },
    "tradeId": "trade_demo",
    "tradeRef": "0xabababababababababababababababababababababababababababababababab",
    "transactionHash": "0xabababababababababababababababababababababababababababababababab",
    "transferNumber": "B2B-DEMO",
    "type": "SELL",
    "updatedAt": "2026-10-23T10:00:00.000Z",
    "walletAddress": "0x19e7e376e7c213b7e7e7e46cc70a5dd086daff2a"
  }
}

Get transaction confirmation status.

Credential: Customer session or partner secret

Before you call

A customer session, or an owning partner server credential without Origin.
Use the original preparationId and the customer’s registered wallet.
Keep the signed bytes and any known hashes if you need to recover an uncertain submission.

Reads the status of a transaction for the authenticated wallet, and resumes Sinbad’s tracking if it was interrupted. CONFIRMED means a successful receipt, or a funded breakdown or trade that Sinbad has already verified at the usual confirmation depth. Wallet escrow tracking that stays unresolved for 24 hours becomes REVIEW_REQUIRED, whatever the funding state. Trade status continues to follow events and receipts.

A prepared transaction stays available while its trade, breakdown or transaction protection is unresolved, and a completed transaction keeps its completed status on later polls. After a transaction completes or its breakdown closes, Sinbad keeps the evidence for at least 30 days before it cleans it up. Sinbad never deletes trades, breakdowns or disputes.

Confirm with Sinbad that this endpoint is enabled in your environment.

Errors

Status	Code	What to do
400	`VALIDATION_ERROR`	Correct the fields reported in details before retrying.
401	`UNAUTHENTICATED`	Create a new customer session or use a valid server credential.
403	`FORBIDDEN`	Check credential ownership, integration and the supplied Origin.
404	`NOT_FOUND`	Check the resource ID. A resource that belongs to someone else also returns 404.
409	`CONFLICT`	Read the current state again before you prepare or retry.
503	`UPSTREAM_ERROR`	Retry with backoff; preserve the same idempotency key for a repeated mutation.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

preparationIdstringRequired

Response

Current tracking status; transactionHash is null before submission.

transactionobject

tradeobject or map from strings to any

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

503

Service Unavailable Error