curl https://catchbackcards.com/api/partner/v2/orders/okx-ord-7f3a9c21/verification \
-H "Authorization: Bearer $CATCHBACK_KEY"
{
"verification": {
"order_id": "okx-ord-7f3a9c21",
"id": "3d2b8f0e-6c1a-4f7e-9a51-2b0d8c4e7f13",
"pull_id": "6a0f...",
"card_id": "a1c4...",
"category": "pokemon",
"verified": true,
"verification_type": "provably_fair",
"verify_url": "https://catchbackcards.com/api/verify-pull?transaction_id=6a0f...&card_source=pokemon",
"proof": { "verified": true, "verification_type": "provably_fair", "...": "the verifier's step-by-step replay" }
}
}
{ "error": "This order has not been opened yet", "code": "NOT_PULLED", "status": "awaiting_payment" }
Packs & orders
Verify an order's pull
The order’s provably-fair proof, and a public URL your customer can open to re-run the check.
GET
/
api
/
partner
/
v2
/
orders
/
{id}
/
verification
curl https://catchbackcards.com/api/partner/v2/orders/okx-ord-7f3a9c21/verification \
-H "Authorization: Bearer $CATCHBACK_KEY"
{
"verification": {
"order_id": "okx-ord-7f3a9c21",
"id": "3d2b8f0e-6c1a-4f7e-9a51-2b0d8c4e7f13",
"pull_id": "6a0f...",
"card_id": "a1c4...",
"category": "pokemon",
"verified": true,
"verification_type": "provably_fair",
"verify_url": "https://catchbackcards.com/api/verify-pull?transaction_id=6a0f...&card_source=pokemon",
"proof": { "verified": true, "verification_type": "provably_fair", "...": "the verifier's step-by-step replay" }
}
}
{ "error": "This order has not been opened yet", "code": "NOT_PULLED", "status": "awaiting_payment" }
Scope:
nft:orders
Every pack is opened provably fairly. This returns the proof for an order’s pull, and a public verify_url your customer can open to re-run the check without a key.
A single order’s
id or Idempotency-Key, or one unit’s id from a multi-pack order. A multi-pack order’s own id or Idempotency-Key returns one proof per unit.Response
Multi-pack orders
A multi-pack order’s ownid or Idempotency-Key returns { order_id, batch_id, verified, units: [...] }: one proof per unit, each with its unit number. A unit not yet opened has "verified": null, "pending": true, and the order’s verified is true only when every unit’s is.
Errors
| Status | Code | When |
|---|---|---|
404 | UNKNOWN_ORDER | No such order in your program |
409 | NOT_PULLED | The order’s pack hasn’t been opened yet; the body has the order’s status |
503 | VERIFY_UNAVAILABLE | The proof couldn’t be loaded right now; retry shortly |
curl https://catchbackcards.com/api/partner/v2/orders/okx-ord-7f3a9c21/verification \
-H "Authorization: Bearer $CATCHBACK_KEY"
{
"verification": {
"order_id": "okx-ord-7f3a9c21",
"id": "3d2b8f0e-6c1a-4f7e-9a51-2b0d8c4e7f13",
"pull_id": "6a0f...",
"card_id": "a1c4...",
"category": "pokemon",
"verified": true,
"verification_type": "provably_fair",
"verify_url": "https://catchbackcards.com/api/verify-pull?transaction_id=6a0f...&card_source=pokemon",
"proof": { "verified": true, "verification_type": "provably_fair", "...": "the verifier's step-by-step replay" }
}
}
{ "error": "This order has not been opened yet", "code": "NOT_PULLED", "status": "awaiting_payment" }

