Sinbad Partner API

{
  "delivery": {
    "deliveryId": "del_demo",
    "eventId": "evt_demo",
    "eventType": "trade.updated",
    "tradeId": "trade_demo",
    "kind": "normal",
    "status": "failed",
    "attemptCount": 1,
    "lastResult": {
      "reason": "HTTP_400",
      "httpStatus": 400,
      "durationMs": 125
    },
    "nextAttemptAt": null,
    "createdAt": "2026-10-23T10:00:00.000Z",
    "completedAt": "2026-10-23T10:00:00.000Z",
    "originalDeliveryId": null,
    "payloadUnavailable": false
  },
  "payload": {
    "id": "evt_demo",
    "type": "trade.updated",
    "apiVersion": "2026-10-22",
    "environment": "sinbad-staging-env",
    "partnerId": "partner_demo",
    "integrationId": "integration_demo",
    "partnerUserId": "customer_demo",
    "tradeId": "trade_demo",
    "sequence": 3,
    "occurredAt": "2026-10-23T10:00:00.000Z",
    "sourceCommittedAt": "2026-10-23T10:00:00.000Z",
    "recordedAt": "2026-10-23T10:00:00.000Z",
    "data": {
      "changedFields": [
        "status",
        "paidAt"
      ],
      "previousStatus": "CREATED",
      "trade": {
        "canceledAt": null,
        "chainId": 80002,
        "createdAt": "2026-10-23T10:00:00.000Z",
        "displayLabel": "Bank transfer",
        "disputeTransactionHash": null,
        "disputedAt": null,
        "escrowAddress": "0x3333333333333333333333333333333333333333",
        "escrowId": "42",
        "fiatCurrencyId": "usd",
        "fundedAt": "2026-10-23T10:00:00.000Z",
        "fundingExpiresAt": null,
        "paidAt": "2026-10-23T10:00:00.000Z",
        "paymentMethodId": "bank_transfer",
        "pricing": {
          "customerFiatAmount": "100",
          "lockAmountUsdt": "100",
          "makerFeeUsdt": "0",
          "partnerFeeUsdt": "0",
          "platformFeeUsdt": "0",
          "recipientAmountUsdt": "100",
          "subtotalFiat": "100",
          "usdtAmount": "100"
        },
        "proofOfPayment": null,
        "releasedAt": null,
        "resolvedAt": null,
        "settlementOutcome": null,
        "settlementTransactionHash": null,
        "side": "BUY",
        "status": "PAID",
        "tokenAddress": "0x4444444444444444444444444444444444444444",
        "tradeId": "trade_demo",
        "tradeRef": "0xabababababababababababababababababababababababababababababababab",
        "transactionHash": "0xabababababababababababababababababababababababababababababababab",
        "transferNumber": "B2B-DEMO"
      }
    }
  },
  "payloadUnavailable": false,
  "attempts": [
    {
      "attemptId": "attempt_demo",
      "number": 1,
      "startedAt": "2026-10-23T10:00:00.000Z",
      "finishedAt": "2026-10-23T10:00:00.000Z",
      "status": "failed",
      "httpStatus": 400,
      "durationMs": 25,
      "reason": "HTTP_400",
      "signingKeyIds": [
        "key_demo"
      ]
    }
  ],
  "nextCursor": null
}

Inspect a webhook delivery.

Credential: Partner secret

Before you call

A server-side partner secret for the owning partner. Do not send an Origin header.
An active integration that your partner credential permits.

Read retained public payload and paginated sanitized attempts

Inspect attempts and lastResult. Delivery retries timeouts, network errors, HTTP 408, 429 and 5xx; other failures are final. HTTP 410 disables the endpoint. Up to 12 attempts within 24 hours of the first attempt; Retry-After is honored for 429 and 503. Replay is available for 30 days from capture.

Server-only partner credential access: a 403 means the integration is unauthorized or inactive. Mutations share 60/min per partner; test and replay allow 5/min each per endpoint, rotation 1/min per endpoint. Only committed changes count; identical idempotent replays within 24 hours do not. A 429 includes retryAfter. Conflict details.kind can include IDEMPOTENCY_CONFLICT, ENDPOINT_DELETED, ENDPOINT_LIMIT, REVISION_CONFLICT, VERIFICATION_REQUIRED, ROTATION_IN_PROGRESS or REPLAY_UNAVAILABLE. Webhook availability depends on environment readiness; confirm it with Sinbad.

Webhook delivery must be available in the selected environment. Confirm readiness with Sinbad.

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`	Use a server credential permitted for this active integration.
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.
429	`RATE_LIMITED`	Wait for Retry-After before retrying.
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.

Path parameters

webhookIdstringRequiredformat: "^[A-Za-z0-9_-]{1,128}$"

deliveryIdstringRequiredformat: "^[A-Za-z0-9_-]{1,128}$"

Query parameters

limitintegerOptional1-100Defaults to 20

cursorstringOptional<=2048 characters

Response headers

Cache-ControlstringOptional

no-store

Response

Success

deliveryobject

payloadobject

payloadUnavailableboolean

attemptslist of objects

nextCursorstring or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

503

Service Unavailable Error