{
"openapi":"3.0.3",
"info":{"title":"PointZero Card Issuing API","version":"2026-10","description":"Issue and manage virtual and physical payment cards.\n\nAll amounts are integers in the smallest currency unit. Requests and responses are JSON. Authenticate with a secret API key in the `Authorization: Bearer` header; keys starting with `sk_test_` work only in the sandbox.\n\nList endpoints use cursor pagination with `limit` and `starting_after`. `POST` requests that create resources accept an `Idempotency-Key` header.","contact":{"name":"PointZero","email":"support@pointzero.io","url":"https://pointzero.io"}},
"servers":[{"url":"https://api.pointzero.io/v1","description":"Production"},{"url":"https://sandbox.api.pointzero.io/v1","description":"Sandbox"}],
"security":[{"bearerAuth":[]}],
"tags":[
{"name":"Programs","description":"Card programs configured for your account."},
{"name":"Customers","description":"Individuals and businesses that hold cards."},
{"name":"Cards","description":"Issue and manage the card lifecycle."},
{"name":"Authorization Controls","description":"Merchant, country and channel rules."},
{"name":"3D Secure","description":"3DS settings for online payments."},
{"name":"Wallets","description":"Apple Pay and Google Pay tokens."},
{"name":"Physical Cards","description":"Production and delivery of plastic cards."},
{"name":"PIN","description":"PIN management for physical cards."},
{"name":"Transactions","description":"Authorizations, refunds and settlements."},
{"name":"Disputes","description":"Chargebacks on card transactions."}],
"paths":{
"/programs":{"get":{"tags":["Programs"],"operationId":"listPrograms","summary":"List programs","description":"Returns the card programs available to your account.","parameters":[{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/StartingAfter"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgramList"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/programs/{program_id}":{"get":{"tags":["Programs"],"operationId":"getProgram","summary":"Retrieve a program","description":"Returns a single card program by its ID.","parameters":[{"$ref":"#/components/parameters/ProgramId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Program"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/customers":{
"post":{"tags":["Customers"],"operationId":"createCustomer","summary":"Create a customer","description":"Creates an individual or business customer that you can issue cards to. Add a `phone` in E.164 format if you plan to provision the customer's cards to a wallet or use 3DS OTP.","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerCreate"}}}},"responses":{"201":{"description":"Created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customer"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},
"get":{"tags":["Customers"],"operationId":"listCustomers","summary":"List customers","description":"Returns your customers. Filter by `external_id` to find a customer by your own identifier.","parameters":[{"name":"external_id","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string","enum":["active","inactive"]}},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/StartingAfter"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerList"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/customers/{customer_id}":{
"get":{"tags":["Customers"],"operationId":"getCustomer","summary":"Retrieve a customer","description":"Returns a single customer by its ID.","parameters":[{"$ref":"#/components/parameters/CustomerId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customer"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},
"patch":{"tags":["Customers"],"operationId":"updateCustomer","summary":"Update a customer","description":"Updates the given fields. Fields not included are left unchanged.","parameters":[{"$ref":"#/components/parameters/CustomerId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerUpdate"}}}},"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customer"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards":{
"post":{"tags":["Cards"],"operationId":"createCard","summary":"Create a card","description":"Issues a virtual or physical card to a customer. Physical cards stay `pending` until a physical card order is created and delivered.","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardCreate"}}}},"responses":{"201":{"description":"Created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},
"get":{"tags":["Cards"],"operationId":"listCards","summary":"List cards","description":"Returns cards. Filter by customer, program, status or type.","parameters":[{"name":"customer_id","in":"query","schema":{"type":"string"}},{"name":"program_id","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string","enum":["pending","active","frozen","terminated"],"description":"`pending` until the card is ready for use. `terminated` is final."}},{"name":"type","in":"query","schema":{"type":"string","enum":["virtual","physical"]}},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/StartingAfter"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardList"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}":{
"get":{"tags":["Cards"],"operationId":"getCard","summary":"Retrieve a card","description":"Returns a single card by its ID. The full card number and CVC are never returned.","parameters":[{"$ref":"#/components/parameters/CardId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},
"patch":{"tags":["Cards"],"operationId":"updateCard","summary":"Update a card","description":"Updates the cardholder name or metadata. Use the dedicated endpoints to change limits, controls or status.","parameters":[{"$ref":"#/components/parameters/CardId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardUpdate"}}}},"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/freeze":{"post":{"tags":["Cards"],"operationId":"freezeCard","summary":"Freeze a card","description":"Declines new authorizations until the card is unfrozen. Pending authorizations and refunds are still processed.","parameters":[{"$ref":"#/components/parameters/CardId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/unfreeze":{"post":{"tags":["Cards"],"operationId":"unfreezeCard","summary":"Unfreeze a card","description":"Returns a frozen card to `active`.","parameters":[{"$ref":"#/components/parameters/CardId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/terminate":{"post":{"tags":["Cards"],"operationId":"terminateCard","summary":"Terminate a card","description":"Permanently closes the card. This cannot be undone.","parameters":[{"$ref":"#/components/parameters/CardId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/replace":{"post":{"tags":["Cards"],"operationId":"replaceCard","summary":"Replace a card","description":"Issues a new card with the same customer, program and controls.","parameters":[{"$ref":"#/components/parameters/CardId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardReplace"}}}},"responses":{"201":{"description":"Created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/spending-controls":{"put":{"tags":["Cards"],"operationId":"updateSpendingControls","summary":"Update spending controls","description":"Replaces the card's spending limits.","parameters":[{"$ref":"#/components/parameters/CardId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpendingControls"}}}},"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/authorization-controls":{
"get":{"tags":["Authorization Controls"],"operationId":"getAuthorizationControls","summary":"Retrieve authorization controls","description":"Returns the merchant category, country and channel rules applied to the card.","parameters":[{"$ref":"#/components/parameters/CardId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationControls"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},
"put":{"tags":["Authorization Controls"],"operationId":"updateAuthorizationControls","summary":"Update authorization controls","description":"Replaces the merchant category, country and channel rules for the card.","parameters":[{"$ref":"#/components/parameters/CardId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationControls"}}}},"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationControls"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/3ds":{
"get":{"tags":["3D Secure"],"operationId":"getThreeDSConfig","summary":"Retrieve 3DS settings","description":"Returns the 3-D Secure settings for card-not-present transactions on the card.","parameters":[{"$ref":"#/components/parameters/CardId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreeDSConfig"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},
"put":{"tags":["3D Secure"],"operationId":"updateThreeDSConfig","summary":"Update 3DS settings","description":"Sets 3-D Secure behavior for card-not-present transactions.","parameters":[{"$ref":"#/components/parameters/CardId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreeDSConfig"}}}},"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreeDSConfig"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/wallet-tokens":{
"get":{"tags":["Wallets"],"operationId":"listWalletTokens","summary":"List wallet tokens","description":"Returns the Apple Pay and Google Pay tokens linked to the card.","parameters":[{"$ref":"#/components/parameters/CardId"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/StartingAfter"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletTokenList"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},
"post":{"tags":["Wallets"],"operationId":"provisionWalletToken","summary":"Provision to a wallet","description":"Starts push provisioning of the card to Apple Pay or Google Pay. The token is `pending` until the wallet confirms it.","parameters":[{"$ref":"#/components/parameters/CardId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletProvisionRequest"}}}},"responses":{"201":{"description":"Created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletToken"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/wallet-tokens/{wallet_token_id}":{"delete":{"tags":["Wallets"],"operationId":"deleteWalletToken","summary":"Remove from a wallet","description":"Removes the wallet token so the card can no longer be used from that device.","parameters":[{"$ref":"#/components/parameters/CardId"},{"$ref":"#/components/parameters/WalletTokenId"}],"responses":{"204":{"description":"No content."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/physical-order":{
"post":{"tags":["Physical Cards"],"operationId":"createPhysicalCardOrder","summary":"Order a physical card","description":"Orders production and delivery of a physical card. The card stays `pending` until the order is delivered.","parameters":[{"$ref":"#/components/parameters/CardId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhysicalCardOrderCreate"}}}},"responses":{"201":{"description":"Created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhysicalCardOrder"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},
"get":{"tags":["Physical Cards"],"operationId":"getPhysicalCardOrder","summary":"Retrieve a physical card order","description":"Returns the order status, carrier and tracking number for the card.","parameters":[{"$ref":"#/components/parameters/CardId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhysicalCardOrder"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/physical-order/cancel":{"post":{"tags":["Physical Cards"],"operationId":"cancelPhysicalCardOrder","summary":"Cancel a physical card order","description":"Only possible while the order is `pending`.","parameters":[{"$ref":"#/components/parameters/CardId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhysicalCardOrder"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/pin":{
"get":{"tags":["PIN"],"operationId":"getPinStatus","summary":"Retrieve PIN status","description":"Returns whether a PIN is set. The PIN itself is never returned.","parameters":[{"$ref":"#/components/parameters/CardId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinStatus"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},
"put":{"tags":["PIN"],"operationId":"setPin","summary":"Set PIN","description":"Sets or changes the PIN of a physical card.","parameters":[{"$ref":"#/components/parameters/CardId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinSetRequest"}}}},"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinStatus"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/cards/{card_id}/pin/unblock":{"post":{"tags":["PIN"],"operationId":"unblockPin","summary":"Unblock PIN","description":"Resets the incorrect-attempt counter on a blocked PIN.","parameters":[{"$ref":"#/components/parameters/CardId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinStatus"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/transactions":{"get":{"tags":["Transactions"],"operationId":"listTransactions","summary":"List transactions","description":"Returns transactions, newest first.","parameters":[{"name":"card_id","in":"query","schema":{"type":"string"}},{"name":"customer_id","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string","enum":["authorized","declined","reversed","settled"]}},{"name":"currency","in":"query","schema":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter ISO 4217 currency code.","example":"EUR"}},{"name":"created_gte","in":"query","schema":{"type":"string","format":"date-time"},"description":"Return transactions created at or after this time."},{"name":"created_lt","in":"query","schema":{"type":"string","format":"date-time"},"description":"Return transactions created before this time."},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/StartingAfter"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionList"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/transactions/{transaction_id}":{"get":{"tags":["Transactions"],"operationId":"getTransaction","summary":"Retrieve a transaction","description":"Returns a single transaction by its ID.","parameters":[{"$ref":"#/components/parameters/TransactionId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Transaction"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/disputes":{
"post":{"tags":["Disputes"],"operationId":"createDispute","summary":"Create a dispute","description":"Opens a dispute for a settled transaction.","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeCreate"}}}},"responses":{"201":{"description":"Created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},
"get":{"tags":["Disputes"],"operationId":"listDisputes","summary":"List disputes","description":"Returns disputes. Filter by status or transaction.","parameters":[{"name":"status","in":"query","schema":{"type":"string","enum":["open","under_review","won","lost","withdrawn"]}},{"name":"transaction_id","in":"query","schema":{"type":"string"}},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/StartingAfter"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeList"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},
"/disputes/{dispute_id}":{"get":{"tags":["Disputes"],"operationId":"getDispute","summary":"Retrieve a dispute","description":"Returns a single dispute by its ID.","parameters":[{"$ref":"#/components/parameters/DisputeId"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}}
},
"components":{
"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Secret API key, e.g. `sk_live_...` or `sk_test_...`."}},
"parameters":{
"Limit":{"name":"limit","in":"query","description":"Number of items to return.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},
"StartingAfter":{"name":"starting_after","in":"query","description":"Cursor from `next_cursor` of the previous page.","schema":{"type":"string"}},
"IdempotencyKey":{"name":"Idempotency-Key","in":"header","description":"Unique key that makes the request safe to retry. Keys expire after 24 hours.","schema":{"type":"string","maxLength":255},"example":"6f1c2c3e-5d3a-4d2b-9a8e-1f2b3c4d5e6f"},
"CardId":{"name":"card_id","in":"path","required":true,"schema":{"type":"string"},"example":"card_01JZ8N2K4M"},
"CustomerId":{"name":"customer_id","in":"path","required":true,"schema":{"type":"string"},"example":"cus_01JZ8M4X7K"},
"ProgramId":{"name":"program_id","in":"path","required":true,"schema":{"type":"string"},"example":"prog_01JZ8A2K4M"},
"TransactionId":{"name":"transaction_id","in":"path","required":true,"schema":{"type":"string"},"example":"txn_01JZ8P7H2R"},
"DisputeId":{"name":"dispute_id","in":"path","required":true,"schema":{"type":"string"},"example":"dsp_01JZ9C2K4M"},
"WalletTokenId":{"name":"wallet_token_id","in":"path","required":true,"schema":{"type":"string"},"example":"wlt_01JZ9A2K4M"}},
"responses":{
"BadRequest":{"description":"The request is malformed or missing required parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},
"Unauthorized":{"description":"The API key is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},
"Forbidden":{"description":"The API key does not have access to this resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},
"NotFound":{"description":"The resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},
"Conflict":{"description":"The request conflicts with the current state of the resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},
"UnprocessableEntity":{"description":"The request is well-formed but failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},
"TooManyRequests":{"description":"Too many requests. Retry after the time given in `Retry-After`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."}}}},
"schemas":{
"Program":{"type":"object","description":"A card program defines the BIN, network, currencies and card types available to your account.","required":["id","object","name","status"],"properties":{"id":{"type":"string","description":"Unique identifier, prefixed with `prog_`.","example":"prog_01JZ8A2K4M","readOnly":true},"object":{"type":"string","enum":["program"],"description":"Object type.","readOnly":true},"name":{"type":"string","example":"Corporate Cards"},"status":{"type":"string","enum":["active","inactive"]},"network":{"type":"string","enum":["visa","mastercard"],"example":"visa"},"supported_card_types":{"type":"array","items":{"type":"string","enum":["virtual","physical"]}},"supported_currencies":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter ISO 4217 currency code.","example":"EUR"}},"created_at":{"type":"string","format":"date-time","description":"Time the program was created.","readOnly":true}}},
"Customer":{"type":"object","description":"An individual or business that cards are issued to.","required":["id","object","type","status","created_at"],"properties":{"id":{"type":"string","description":"Unique identifier, prefixed with `cus_`.","example":"cus_01JZ8M4X7K","readOnly":true},"object":{"type":"string","enum":["customer"],"description":"Object type.","readOnly":true},"type":{"type":"string","enum":["individual","business"]},"external_id":{"type":"string","description":"Your own identifier for this customer. Must be unique within your account.","example":"user_10492"},"name":{"type":"object","properties":{"first":{"type":"string","maxLength":100,"example":"Alex"},"last":{"type":"string","maxLength":100,"example":"Morgan"}}},"email":{"type":"string","format":"email","example":"alex.morgan@example.com"},"phone":{"type":"string","description":"Phone number in E.164 format. Required for wallet provisioning and 3DS OTP delivery.","example":"+34600000000"},"status":{"type":"string","enum":["active","inactive"]},"metadata":{"type":"object","description":"Up to 50 key-value pairs for your own reference. Values are strings up to 500 characters.","additionalProperties":{"type":"string","maxLength":500},"example":{"cost_center":"marketing"}},"created_at":{"type":"string","format":"date-time","description":"Time the customer was created.","readOnly":true},"updated_at":{"type":"string","format":"date-time","description":"Time the customer was last updated.","readOnly":true}}},
"CustomerCreate":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["individual","business"]},"external_id":{"type":"string","description":"Your own identifier for this customer. Must be unique within your account.","example":"user_10492"},"name":{"type":"object","properties":{"first":{"type":"string","maxLength":100,"example":"Alex"},"last":{"type":"string","maxLength":100,"example":"Morgan"}}},"email":{"type":"string","format":"email","example":"alex.morgan@example.com"},"phone":{"type":"string","description":"Phone number in E.164 format. Required for wallet provisioning and 3DS OTP delivery.","example":"+34600000000"},"metadata":{"type":"object","description":"Up to 50 key-value pairs for your own reference. Values are strings up to 500 characters.","additionalProperties":{"type":"string","maxLength":500},"example":{"cost_center":"marketing"}}}},
"CustomerUpdate":{"type":"object","minProperties":1,"properties":{"name":{"type":"object","properties":{"first":{"type":"string","maxLength":100,"example":"Alex"},"last":{"type":"string","maxLength":100,"example":"Morgan"}}},"email":{"type":"string","format":"email","example":"alex.morgan@example.com"},"phone":{"type":"string","description":"Phone number in E.164 format. Required for wallet provisioning and 3DS OTP delivery.","example":"+34600000000"},"metadata":{"type":"object","description":"Up to 50 key-value pairs for your own reference. Values are strings up to 500 characters.","additionalProperties":{"type":"string","maxLength":500},"example":{"cost_center":"marketing"}}}},
"SpendingControls":{"type":"object","description":"Card-level spending limits. Omitted or `null` limits are not enforced.","properties":{"single_transaction_limit":{"type":"integer","format":"int64","minimum":0,"description":"Maximum amount of a single authorization. In the smallest currency unit (e.g. cents).","nullable":true,"example":100000},"daily_limit":{"type":"integer","format":"int64","minimum":0,"description":"Maximum total authorized per calendar day (UTC). In the smallest currency unit (e.g. cents).","nullable":true,"example":500000},"monthly_limit":{"type":"integer","format":"int64","minimum":0,"description":"Maximum total authorized per calendar month (UTC). In the smallest currency unit (e.g. cents).","nullable":true,"example":2500000}}},
"Card":{"type":"object","description":"A virtual or physical payment card. Full card number and CVC are never returned by this API.","required":["id","object","customer_id","program_id","type","status","currency","created_at"],"properties":{"id":{"type":"string","description":"Unique identifier, prefixed with `card_`.","example":"card_01JZ8N2K4M","readOnly":true},"object":{"type":"string","enum":["card"],"description":"Object type.","readOnly":true},"customer_id":{"type":"string","example":"cus_01JZ8M4X7K"},"program_id":{"type":"string","example":"prog_01JZ8A2K4M"},"type":{"type":"string","enum":["virtual","physical"]},"status":{"type":"string","enum":["pending","active","frozen","terminated"],"description":"`pending` until the card is ready for use. `terminated` is final."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter ISO 4217 currency code.","example":"EUR"},"cardholder":{"type":"object","properties":{"name":{"type":"string","maxLength":26,"description":"Name as printed on the card.","example":"ALEX MORGAN"}}},"brand":{"type":"string","enum":["visa","mastercard"],"readOnly":true},"last4":{"type":"string","pattern":"^[0-9]{4}$","readOnly":true,"example":"4821"},"expiry":{"type":"object","readOnly":true,"properties":{"month":{"type":"integer","minimum":1,"maximum":12,"example":11},"year":{"type":"integer","example":2029}}},"spending_controls":{"$ref":"#/components/schemas/SpendingControls"},"replaced_card_id":{"type":"string","nullable":true,"description":"ID of the card this card replaced, if any.","readOnly":true},"metadata":{"type":"object","description":"Up to 50 key-value pairs for your own reference. Values are strings up to 500 characters.","additionalProperties":{"type":"string","maxLength":500},"example":{"cost_center":"marketing"}},"created_at":{"type":"string","format":"date-time","description":"Time the card was created.","readOnly":true},"updated_at":{"type":"string","format":"date-time","description":"Time the card was last updated.","readOnly":true}}},
"CardCreate":{"type":"object","required":["customer_id","type","currency"],"properties":{"customer_id":{"type":"string","example":"cus_01JZ8M4X7K"},"program_id":{"type":"string","description":"Defaults to the account's default program.","example":"prog_01JZ8A2K4M"},"type":{"type":"string","enum":["virtual","physical"]},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter ISO 4217 currency code.","example":"EUR"},"cardholder":{"type":"object","properties":{"name":{"type":"string","maxLength":26,"description":"Name as printed on the card.","example":"ALEX MORGAN"}}},"spending_controls":{"$ref":"#/components/schemas/SpendingControls"},"metadata":{"type":"object","description":"Up to 50 key-value pairs for your own reference. Values are strings up to 500 characters.","additionalProperties":{"type":"string","maxLength":500},"example":{"cost_center":"marketing"}}}},
"CardUpdate":{"type":"object","minProperties":1,"properties":{"cardholder":{"type":"object","properties":{"name":{"type":"string","maxLength":26,"description":"Name as printed on the card.","example":"ALEX MORGAN"}}},"metadata":{"type":"object","description":"Up to 50 key-value pairs for your own reference. Values are strings up to 500 characters.","additionalProperties":{"type":"string","maxLength":500},"example":{"cost_center":"marketing"}}}},
"CardReplace":{"type":"object","required":["reason"],"properties":{"reason":{"type":"string","enum":["lost","stolen","damaged","expired","other"]},"type":{"type":"string","enum":["virtual","physical"],"description":"Defaults to the type of the existing card."},"terminate_existing":{"type":"boolean","default":true,"description":"Terminate the existing card once the replacement is created. Always `true` for `lost` and `stolen`."}}},
"Transaction":{"type":"object","required":["id","object","card_id","amount","currency","status","created_at"],"properties":{"id":{"type":"string","description":"Unique identifier, prefixed with `txn_`.","example":"txn_01JZ8P7H2R","readOnly":true},"object":{"type":"string","enum":["transaction"],"description":"Object type.","readOnly":true},"card_id":{"type":"string","example":"card_01JZ8N2K4M"},"customer_id":{"type":"string","example":"cus_01JZ8M4X7K"},"type":{"type":"string","enum":["purchase","refund","cash_withdrawal"],"example":"purchase"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"Transaction amount in the card currency. In the smallest currency unit (e.g. cents).","example":1299},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter ISO 4217 currency code.","example":"EUR"},"merchant_amount":{"type":"integer","format":"int64","minimum":0,"description":"Amount in the merchant currency. In the smallest currency unit (e.g. cents).","example":1299},"merchant_currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter ISO 4217 currency code.","example":"EUR"},"status":{"type":"string","enum":["authorized","declined","reversed","settled"]},"decline_reason":{"type":"string","nullable":true,"enum":["insufficient_funds","card_frozen","spending_limit_exceeded","authorization_control","incorrect_pin","suspected_fraud","other"],"description":"Set when `status` is `declined`."},"merchant":{"type":"object","properties":{"name":{"type":"string","example":"ACME STORE"},"mcc":{"type":"string","pattern":"^[0-9]{4}$","example":"5411"},"city":{"type":"string","example":"Valencia"},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"Two-letter ISO 3166-1 alpha-2 country code.","example":"ES"}}},"channel":{"type":"string","enum":["online","in_store","contactless","atm"]},"created_at":{"type":"string","format":"date-time","description":"Time of authorization.","readOnly":true},"settled_at":{"type":"string","format":"date-time","description":"Time of settlement.","readOnly":true,"nullable":true}}},
"AuthorizationControls":{"type":"object","description":"Rules applied to every authorization on the card. `allowed_*` and `blocked_*` lists of the same kind cannot both be set.","properties":{"allowed_mccs":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}$"},"description":"Only these merchant category codes are allowed."},"blocked_mccs":{"type":"array","items":{"type":"string","pattern":"^[0-9]{4}$"},"description":"These merchant category codes are declined."},"allowed_countries":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"Two-letter ISO 3166-1 alpha-2 country code.","example":"ES"}},"blocked_countries":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"Two-letter ISO 3166-1 alpha-2 country code.","example":"ES"}},"allow_online":{"type":"boolean","default":true},"allow_contactless":{"type":"boolean","default":true},"allow_cash_withdrawal":{"type":"boolean","default":false}}},
"ThreeDSConfig":{"type":"object","properties":{"enabled":{"type":"boolean","default":true},"challenge_preference":{"type":"string","enum":["no_preference","challenge_requested","challenge_avoided"],"default":"no_preference"},"exemptions":{"type":"array","items":{"type":"string","enum":["low_value","trusted_beneficiary","transaction_risk_analysis"]},"description":"SCA exemptions the issuer may apply."}}},
"WalletToken":{"type":"object","required":["id","object","card_id","wallet","status"],"properties":{"id":{"type":"string","description":"Unique identifier, prefixed with `wlt_`.","example":"wlt_01JZ9A2K4M","readOnly":true},"object":{"type":"string","enum":["wallet_token"],"description":"Object type.","readOnly":true},"card_id":{"type":"string","example":"card_01JZ8N2K4M"},"wallet":{"type":"string","enum":["apple_pay","google_pay"]},"status":{"type":"string","enum":["pending","active","suspended","removed"]},"device_name":{"type":"string","nullable":true,"example":"Alex's iPhone"},"created_at":{"type":"string","format":"date-time","description":"Time provisioning was requested.","readOnly":true}}},
"WalletProvisionRequest":{"type":"object","required":["wallet"],"properties":{"wallet":{"type":"string","enum":["apple_pay","google_pay"]},"device_id":{"type":"string","description":"Device identifier supplied by the wallet SDK."},"device_name":{"type":"string"}}},
"PhysicalCardOrder":{"type":"object","required":["id","object","card_id","status","created_at"],"properties":{"id":{"type":"string","description":"Unique identifier, prefixed with `ord_`.","example":"ord_01JZ9B2K4M","readOnly":true},"object":{"type":"string","enum":["physical_card_order"],"description":"Object type.","readOnly":true},"card_id":{"type":"string","example":"card_01JZ8N2K4M"},"status":{"type":"string","enum":["pending","processing","shipped","delivered","cancelled"]},"shipping_method":{"type":"string","enum":["standard","express"]},"shipping_address":{"type":"object","required":["line1","city","postal_code","country"],"properties":{"line1":{"type":"string","example":"Calle de Colón 1"},"line2":{"type":"string"},"city":{"type":"string","example":"Valencia"},"state":{"type":"string","description":"State, province or region."},"postal_code":{"type":"string","example":"46004"},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"Two-letter ISO 3166-1 alpha-2 country code.","example":"ES"}}},"carrier":{"type":"string","nullable":true,"example":"DHL"},"tracking_number":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time","description":"Time the order was created.","readOnly":true},"shipped_at":{"type":"string","format":"date-time","description":"Time the card was shipped.","readOnly":true,"nullable":true}}},
"PhysicalCardOrderCreate":{"type":"object","required":["shipping_address"],"properties":{"shipping_method":{"type":"string","enum":["standard","express"],"default":"standard"},"shipping_address":{"type":"object","required":["line1","city","postal_code","country"],"properties":{"line1":{"type":"string","example":"Calle de Colón 1"},"line2":{"type":"string"},"city":{"type":"string","example":"Valencia"},"state":{"type":"string","description":"State, province or region."},"postal_code":{"type":"string","example":"46004"},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"Two-letter ISO 3166-1 alpha-2 country code.","example":"ES"}}}}},
"PinSetRequest":{"type":"object","required":["encrypted_pin_block"],"properties":{"encrypted_pin_block":{"type":"string","description":"ISO 9564 format 4 PIN block, encrypted with the PIN key issued to your account. Plain-text PINs are not accepted."}}},
"PinStatus":{"type":"object","required":["object","card_id","status"],"properties":{"object":{"type":"string","enum":["pin_status"],"description":"Object type.","readOnly":true},"card_id":{"type":"string","example":"card_01JZ8N2K4M"},"status":{"type":"string","enum":["set","not_set","blocked"]},"remaining_attempts":{"type":"integer","minimum":0,"example":3}}},
"Dispute":{"type":"object","required":["id","object","transaction_id","amount","currency","reason","status","created_at"],"properties":{"id":{"type":"string","description":"Unique identifier, prefixed with `dsp_`.","example":"dsp_01JZ9C2K4M","readOnly":true},"object":{"type":"string","enum":["dispute"],"description":"Object type.","readOnly":true},"transaction_id":{"type":"string","example":"txn_01JZ8P7H2R"},"amount":{"type":"integer","format":"int64","minimum":0,"description":"Disputed amount. In the smallest currency unit (e.g. cents).","example":1299},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter ISO 4217 currency code.","example":"EUR"},"reason":{"type":"string","enum":["fraud","duplicate","incorrect_amount","goods_not_received","goods_not_as_described","other"]},"status":{"type":"string","enum":["open","under_review","won","lost","withdrawn"]},"evidence":{"type":"object","additionalProperties":true},"created_at":{"type":"string","format":"date-time","description":"Time the dispute was opened.","readOnly":true},"resolved_at":{"type":"string","format":"date-time","description":"Time the dispute was resolved.","readOnly":true,"nullable":true}}},
"DisputeCreate":{"type":"object","required":["transaction_id","reason"],"properties":{"transaction_id":{"type":"string","example":"txn_01JZ8P7H2R"},"reason":{"type":"string","enum":["fraud","duplicate","incorrect_amount","goods_not_received","goods_not_as_described","other"]},"amount":{"type":"integer","format":"int64","minimum":1,"description":"Defaults to the full transaction amount."},"evidence":{"type":"object","additionalProperties":true,"description":"Free-form supporting details, e.g. a description or file IDs."}}},
"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request","authentication_error","permission_error","not_found","conflict","rate_limit","api_error"]},"code":{"type":"string","example":"card_not_active"},"message":{"type":"string","example":"The card must be active to perform this action."},"param":{"type":"string","nullable":true,"example":"card_id"},"request_id":{"type":"string","example":"req_01JZ8R2Q4V"}}}}},
"ProgramList":{"type":"object","required":["object","data","has_more"],"properties":{"object":{"type":"string","enum":["list"],"description":"Object type.","readOnly":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Program"}},"has_more":{"type":"boolean"},"next_cursor":{"type":"string","nullable":true,"description":"Pass as `starting_after` to get the next page."}}},
"CustomerList":{"type":"object","required":["object","data","has_more"],"properties":{"object":{"type":"string","enum":["list"],"description":"Object type.","readOnly":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Customer"}},"has_more":{"type":"boolean"},"next_cursor":{"type":"string","nullable":true,"description":"Pass as `starting_after` to get the next page."}}},
"CardList":{"type":"object","required":["object","data","has_more"],"properties":{"object":{"type":"string","enum":["list"],"description":"Object type.","readOnly":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Card"}},"has_more":{"type":"boolean"},"next_cursor":{"type":"string","nullable":true,"description":"Pass as `starting_after` to get the next page."}}},
"WalletTokenList":{"type":"object","required":["object","data","has_more"],"properties":{"object":{"type":"string","enum":["list"],"description":"Object type.","readOnly":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/WalletToken"}},"has_more":{"type":"boolean"},"next_cursor":{"type":"string","nullable":true,"description":"Pass as `starting_after` to get the next page."}}},
"TransactionList":{"type":"object","required":["object","data","has_more"],"properties":{"object":{"type":"string","enum":["list"],"description":"Object type.","readOnly":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Transaction"}},"has_more":{"type":"boolean"},"next_cursor":{"type":"string","nullable":true,"description":"Pass as `starting_after` to get the next page."}}},
"DisputeList":{"type":"object","required":["object","data","has_more"],"properties":{"object":{"type":"string","enum":["list"],"description":"Object type.","readOnly":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Dispute"}},"has_more":{"type":"boolean"},"next_cursor":{"type":"string","nullable":true,"description":"Pass as `starting_after` to get the next page."}}}
}}}