Fetch a conversion

curl --request GET \
  --url https://api.paystack.com/v1/conversions/{conversionId} \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Conversion fetched successfully",
  "code": "ok",
  "data": {
    "id": "con_01KPBH8MD6R7YDJ82T4D6M3V1T",
    "reference": "INV-2026-001",
    "status": "created",
    "quote_id": "quo_01KPBK123456789ABCDEFG",
    "rate_source": "quoted",
    "customer": {
      "id": "cust_seed_alice",
      "type": "individual",
      "name": "Alice Johnson",
      "email": "alice.seed@globalstack.mock",
      "tier": "tier_2",
      "created_at": "2026-04-16T16:14:08.000Z",
      "updated_at": "2026-04-16T16:14:08.000Z"
    },
    "source_wallet": {
      "id": "wal_seed_alice_usdc",
      "currency": "USDC",
      "label": "USDC Wallet"
    },
    "destination_wallet": {
      "id": "wal_seed_alice_usdc",
      "currency": "USDC",
      "label": "USDC Wallet"
    },
    "source_amount": "1.000000",
    "source_currency": "USDC",
    "destination_currency": "NGN",
    "rate": "0.000000",
    "metadata": {
      "payout_batch": "batch_001"
    },
    "created_at": "2026-04-16T16:16:24.000Z",
    "updated_at": "2026-04-16T16:16:26.000Z",
    "destination_amount": "0.00",
    "failure_reason": null
  },
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Conversions

Fetch a conversion

Fetches a single conversion by its external id (prefixed con_), scoped to the calling integration.

Path parameter

id — required. The conversion’s external id (e.g. con_01KPBH8MD6R7YDJ82T4D6M3V1T). A value that is not a valid con_… id returns 400. An id that does not exist or belongs to a different integration returns 404.

Example

GET /v1/conversions/con_01KPBH8MD6R7YDJ82T4D6M3V1T

GET

conversions

{conversionId}

Fetch a conversion

curl --request GET \
  --url https://api.paystack.com/v1/conversions/{conversionId} \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Conversion fetched successfully",
  "code": "ok",
  "data": {
    "id": "con_01KPBH8MD6R7YDJ82T4D6M3V1T",
    "reference": "INV-2026-001",
    "status": "created",
    "quote_id": "quo_01KPBK123456789ABCDEFG",
    "rate_source": "quoted",
    "customer": {
      "id": "cust_seed_alice",
      "type": "individual",
      "name": "Alice Johnson",
      "email": "alice.seed@globalstack.mock",
      "tier": "tier_2",
      "created_at": "2026-04-16T16:14:08.000Z",
      "updated_at": "2026-04-16T16:14:08.000Z"
    },
    "source_wallet": {
      "id": "wal_seed_alice_usdc",
      "currency": "USDC",
      "label": "USDC Wallet"
    },
    "destination_wallet": {
      "id": "wal_seed_alice_usdc",
      "currency": "USDC",
      "label": "USDC Wallet"
    },
    "source_amount": "1.000000",
    "source_currency": "USDC",
    "destination_currency": "NGN",
    "rate": "0.000000",
    "metadata": {
      "payout_batch": "batch_001"
    },
    "created_at": "2026-04-16T16:16:24.000Z",
    "updated_at": "2026-04-16T16:16:26.000Z",
    "destination_amount": "0.00",
    "failure_reason": null
  },
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Authorizations

Authorization

string

header

required

API key issued during merchant onboarding.

Path Parameters

conversionId

string

required

Pattern: [^\/#\?]+?

Response

Conversion fetched successfully

status

enum<boolean>

required

Available options:

true

Example:

true

message

string

required

Human-readable summary

Example:

"Conversion fetched successfully"

code

enum<string>

required

Available options:

ok

Example:

"ok"

data

object

required

Show child attributes