Get Conversion

curl "https://sandbox-api.tender.cash/v1/api/conversions/66aec7de809b7f45c42a49f9" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>"

{
  "status": "success",
  "message": "success",
  "data": {
    "_id": "66aec7de809b7f45c42a49f9",
    "type": "crypto",
    "status": "processing",
    "amount": 100,
    "usdAmount": 100,
    "rate": 0.006667,
    "fee": 0.5,
    "feeUSD": 0.5,
    "chain": "64f7a1c2e4b0a1b2c3d4e5f6",
    "currency": "64fc11d2e4b0a1b2c3d4e5f7",
    "swapChain": { "id": "solana", "name": "Solana", "chainType": "sol" },
    "swapCurrency": "64fc11d2e4b0a1b2c3d4e5f8",
    "convertedAmount": 0.6633,
    "destinationCrypto": { "chain": "solana", "coin": "sol", "address": "7xKX...9fQ" },
    "initiatedVia": "api",
    "processingStages": {
      "sendForConversion": { "status": "completed" },
      "conversionState": { "status": "completed" },
      "settleCrypto": { "status": "executed" }
    },
    "createdAt": "2026-10-15T09:20:15.650Z",
    "updatedAt": "2026-10-15T09:25:00.000Z"
  }
}

{
  "status": "error",
  "message": "Invalid Reference",
  "data": {}
}

GET

api

conversions

{id}

curl "https://sandbox-api.tender.cash/v1/api/conversions/66aec7de809b7f45c42a49f9" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>"

{
  "status": "success",
  "message": "success",
  "data": {
    "_id": "66aec7de809b7f45c42a49f9",
    "type": "crypto",
    "status": "processing",
    "amount": 100,
    "usdAmount": 100,
    "rate": 0.006667,
    "fee": 0.5,
    "feeUSD": 0.5,
    "chain": "64f7a1c2e4b0a1b2c3d4e5f6",
    "currency": "64fc11d2e4b0a1b2c3d4e5f7",
    "swapChain": { "id": "solana", "name": "Solana", "chainType": "sol" },
    "swapCurrency": "64fc11d2e4b0a1b2c3d4e5f8",
    "convertedAmount": 0.6633,
    "destinationCrypto": { "chain": "solana", "coin": "sol", "address": "7xKX...9fQ" },
    "initiatedVia": "api",
    "processingStages": {
      "sendForConversion": { "status": "completed" },
      "conversionState": { "status": "completed" },
      "settleCrypto": { "status": "executed" }
    },
    "createdAt": "2026-10-15T09:20:15.650Z",
    "updatedAt": "2026-10-15T09:25:00.000Z"
  }
}

{
  "status": "error",
  "message": "Invalid Reference",
  "data": {}
}

Auth method: Signed (HMAC) — this endpoint requires the full set of signed headers: x-access-id, x-request-id, x-timestamp, and an HMAC-SHA256 authorization signature. See Authentication.

All conversion endpoints share a bucket of 10 requests per minute per merchant, on top of the general limit. Polling counts against it, so poll no more often than every 10 seconds. See Rate limits.

Headers

string

required

Base64-encoded HMAC-SHA256 signature of {"timeStamp":"<x-timestamp>","requestId":"<x-request-id>","accessId":"<x-access-id>"}, signed with your access secret. The request body is not part of the signature.Example: "pV3n0o8kq0lK2mJ8bZ1yq3Yt6hR0cXK9u4mVJ2l9sE0="

string

required

ISO 8601 timestamp; must be within 5 minutes of server timeExample: "2026-10-15T09:45:53.000Z"

string

required

A unique UUID v4 per requestExample: "550e8400-e29b-41d4-a716-446655440000"

string

required

Your API access ID provided by TenderExample: "your-access-id-here"

Path parameters

string

required

The conversion ID (conversionId from Create Conversion)Example: "66aec7de809b7f45c42a49f9"

Response

string

required

success on successExample: "success"

string

required

Human-readable result messageExample: "success"

object

required

The conversion record

Show data properties

string

Conversion IDExample: "66aec7de809b7f45c42a49f9"

string

crypto or fiatExample: "crypto"

string

Overall status: pending, processing, completed or failed. Use this to decide when the conversion is finished.Example: "processing"

number

Source amount, in the source coinExample: 100

number

Source amount in USD at creationExample: 100

number

Destination units per USD (after fees) used to price the conversionExample: 0.006667

number

Conversion fee, in the source coinExample: 0.5

number

Conversion fee in USDExample: 0.5

string

Internal ID of the source chain record. On this endpoint it is not expanded; use List Conversions if you need the chain details.Example: "64f7a1c2e4b0a1b2c3d4e5f6"

string

Internal ID of the source coin record (not expanded on this endpoint)Example: "64fc11d2e4b0a1b2c3d4e5f7"

object

Destination chain, with id, name, icon and chainType. For fiat conversions its id is fiat.Example: { "id": "solana", "name": "Solana", "chainType": "sol" }

string

Internal ID of the destination coin record (not expanded on this endpoint)Example: "64fc11d2e4b0a1b2c3d4e5f8"

number

Amount obtained from the conversion step, in the destination coin. Set once that step completes.Example: 0.6633

number

Amount delivered to the destination after network and provider fees. Set at settlement.Example: 0.6621

number

Fiat amount paid out (fiat conversions only). Set at settlement.Example: 152340.5

object

Bank details of the payout account (fiat conversions only): currency, accountName, accountNumber, bankName.

object

Crypto destination: chain, coin and address. For type: "crypto" this is your own merchant wallet on the destination chain.Example: { "chain": "solana", "coin": "sol", "address": "7xKX...9fQ" }

string

Why the conversion failed. Present only when status is failed.

string

Where the conversion was created: api, dashboard, admin or auto-payoutExample: "api"

object

Status of each processing stage. Each stage is an object with a single status field.

Show processingStages properties

object

Funds are sent for conversion. Status: pending, initiated, executed, completed or failed.Example: { "status": "completed" }

object

The conversion is executed. Status: pending, executed, completed or failed.Example: { "status": "completed" }

object

Converted funds are settled. Status: pending, executed, completed or failed.Example: { "status": "executed" }

object

Fiat is paid out to the bank account. Present only for fiat conversions. Status: pending, processed, completed or failed.Example: { "status": "pending" }

string

ISO 8601 timestampExample: "2026-10-15T09:20:15.650Z"

string

ISO 8601 timestampExample: "2026-10-15T09:25:00.000Z"

Additional fields may be present; ignore fields you don’t recognise.

Errors

HTTP	Message	Cause
400	`Invalid Reference`	The ID is malformed, does not exist, or belongs to another merchant

curl "https://sandbox-api.tender.cash/v1/api/conversions/66aec7de809b7f45c42a49f9" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>"

{
  "status": "success",
  "message": "success",
  "data": {
    "_id": "66aec7de809b7f45c42a49f9",
    "type": "crypto",
    "status": "processing",
    "amount": 100,
    "usdAmount": 100,
    "rate": 0.006667,
    "fee": 0.5,
    "feeUSD": 0.5,
    "chain": "64f7a1c2e4b0a1b2c3d4e5f6",
    "currency": "64fc11d2e4b0a1b2c3d4e5f7",
    "swapChain": { "id": "solana", "name": "Solana", "chainType": "sol" },
    "swapCurrency": "64fc11d2e4b0a1b2c3d4e5f8",
    "convertedAmount": 0.6633,
    "destinationCrypto": { "chain": "solana", "coin": "sol", "address": "7xKX...9fQ" },
    "initiatedVia": "api",
    "processingStages": {
      "sendForConversion": { "status": "completed" },
      "conversionState": { "status": "completed" },
      "settleCrypto": { "status": "executed" }
    },
    "createdAt": "2026-10-15T09:20:15.650Z",
    "updatedAt": "2026-10-15T09:25:00.000Z"
  }
}

{
  "status": "error",
  "message": "Invalid Reference",
  "data": {}
}

Authorizations

authorization

string

header

required

Signed (HMAC) authentication. Required headers: x-access-id, x-request-id (UUID v4), x-timestamp (ISO 8601, must be within 5 minutes of server time), and authorization: the Base64 HMAC-SHA256 of the JSON string {"timeStamp":"","requestId":"","accessId":""} (keys in that order, no whitespace) using your access secret. The request body, method and path are not signed. The API key must be linked to an outlet.

Headers

authorization

string

required

x-timestamp

string<date-time>

required

ISO 8601 timestamp; must be within 5 minutes of server time

x-request-id

string<uuid>

required

A unique UUID v4 per request

x-access-id

string

required

Path Parameters

string

required

Conversion ID

Response

Conversion

status

string

required

Example:

"success"

message

string

required

Example:

"success"

data

object

required

Additional fields may be present; ignore fields you don't recognise.

Show child attributes

Payment

System

Agents

Conversions

Payouts

Subwallets

Webhooks

On-ramp

Headers

Path parameters

Response

Errors

Authorizations

Headers

Path Parameters

Response

​Headers

​Path parameters

​Response

​Errors

Authorizations

Headers

Path Parameters

Response

Headers

Path parameters

Response

Errors