How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Stripe Issuing API

An API for businesses to instantly create, manage, and distribute payment cards.

Stripe Issuing API is one of 159 APIs that Stripe publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Cards and Issuing. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

This API exposes 27 operations across 17 paths, and defines 42 schemas. It is described by OpenAPI 3.2.0, at version 2023-10-16.

Requests are made against a single base URL, https://api.stripe.com/.

27 operations 17 paths 42 schemas 14 GET13 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2023-10-16
Server
https://api.stripe.com/
Authentication
HTTP Basic, HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 2

Stripe Issuing API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (basicAuth). It accepts HTTP bearer tokens (auth-scheme) (bearerAuth). By default, every request must be authenticated.

  • basicAuth — Basic HTTP authentication. Allowed headers-- Authorization: Basic | Authorization: Basic
  • bearerAuth — Bearer HTTP authentication. Allowed headers-- Authorization: Bearer

Paths & Operations 27

Across 17 paths, the API surfaces 27 operations — 14 GET, 13 POST. Each is listed below with its method, path, parameters, and response codes.

Issuing 27
GET
/v1/issuing/authorizations
Returns a list of Issuing Authorization objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
GetIssuingAuthorizations 8 params body → 200default
GET
/v1/issuing/authorizations/{authorization}
Retrieves an Issuing Authorization object.
GetIssuingAuthorizationsAuthorization 2 params body → 200default
POST
/v1/issuing/authorizations/{authorization}
Updates the specified Issuing Authorization object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PostIssuingAuthorizationsAuthorization 1 param body → 200default
POST
/v1/issuing/authorizations/{authorization}/approve
[Deprecated] Approves a pending Issuing Authorization object. This request should be made within the timeout window of the real-time authorization flow. This method is deprecated. Instead, respond di…
PostIssuingAuthorizationsAuthorizationApprove 1 param body → 200default
POST
/v1/issuing/authorizations/{authorization}/decline
[Deprecated] Declines a pending Issuing Authorization object. This request should be made within the timeout window of the real time authorization flow. This method is deprecated. Instead, respond di…
PostIssuingAuthorizationsAuthorizationDecline 1 param body → 200default
GET
/v1/issuing/cardholders
Returns a list of Issuing Cardholder objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
GetIssuingCardholders 9 params body → 200default
POST
/v1/issuing/cardholders
Creates a new Issuing Cardholder object that can be issued cards.
PostIssuingCardholders body → 200default
GET
/v1/issuing/cardholders/{cardholder}
Retrieves an Issuing Cardholder object.
GetIssuingCardholdersCardholder 2 params body → 200default
POST
/v1/issuing/cardholders/{cardholder}
Updates the specified Issuing Cardholder object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PostIssuingCardholdersCardholder 1 param body → 200default
GET
/v1/issuing/cards
Returns a list of Issuing Card objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
GetIssuingCards 11 params body → 200default
POST
/v1/issuing/cards
Creates an Issuing Card object.
PostIssuingCards body → 200default
GET
/v1/issuing/cards/{card}
Retrieves an Issuing Card object.
GetIssuingCardsCard 2 params body → 200default
POST
/v1/issuing/cards/{card}
Updates the specified Issuing Card object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PostIssuingCardsCard 1 param body → 200default
GET
/v1/issuing/disputes
Returns a list of Issuing Dispute objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
GetIssuingDisputes 7 params body → 200default
POST
/v1/issuing/disputes
Creates an Issuing Dispute object. Individual pieces of evidence within the evidence object are optional at this point. Stripe only validates that required evidence is present during submission. Refe…
PostIssuingDisputes body → 200default
GET
/v1/issuing/disputes/{dispute}
Retrieves an Issuing Dispute object.
GetIssuingDisputesDispute 2 params body → 200default
POST
/v1/issuing/disputes/{dispute}
Updates the specified Issuing Dispute object by setting the values of the parameters passed. Any parameters not provided will be left unchanged. Properties on the evidence object can be unset by pass…
PostIssuingDisputesDispute 1 param body → 200default
POST
/v1/issuing/disputes/{dispute}/submit
Submits an Issuing Dispute to the card network. Stripe validates that all evidence fields required for the dispute’s reason are present. For more details, see Dispute reasons and evidence .
PostIssuingDisputesDisputeSubmit 1 param body → 200default
GET
/v1/issuing/settlements
Returns a list of Issuing Settlement objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
GetIssuingSettlements 5 params body → 200default
GET
/v1/issuing/settlements/{settlement}
Retrieves an Issuing Settlement object.
GetIssuingSettlementsSettlement 2 params body → 200default
POST
/v1/issuing/settlements/{settlement}
Updates the specified Issuing Settlement object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PostIssuingSettlementsSettlement 1 param body → 200default
GET
/v1/issuing/tokens
Lists all Issuing Token objects for a given card.
GetIssuingTokens 7 params body → 200default
GET
/v1/issuing/tokens/{token}
Retrieves an Issuing Token object.
GetIssuingTokensToken 2 params body → 200default
POST
/v1/issuing/tokens/{token}
Attempts to update the specified Issuing Token object to the status specified.
PostIssuingTokensToken 1 param body → 200default
GET
/v1/issuing/transactions
Returns a list of Issuing Transaction objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
GetIssuingTransactions 8 params body → 200default
GET
/v1/issuing/transactions/{transaction}
Retrieves an Issuing Transaction object.
GetIssuingTransactionsTransaction 2 params body → 200default
POST
/v1/issuing/transactions/{transaction}
Updates the specified Issuing Transaction object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PostIssuingTransactionsTransaction 1 param body → 200default

Schemas 42

The contract defines 42 schemas that model the data the API accepts and returns. The most detailed are issuing.authorization (25 properties), issuing.card (23 properties), issuing.transaction (22 properties), issuing.cardholder (16 properties). Each schema is shown below with its type and property counts.

PostIssuingCardholdersCardholderRequest
object
10 properties
IssuingTransactionList
object
4 properties 4 required
issuing.transaction
object
Any use of an [issued card](https://stripe.com/docs/issuing) that results in funds entering or leaving your Stripe account, such as a completed purchase or ref…
22 properties 12 required
issuing.cardholder
object
An Issuing Cardholder object represents an individual or business entity who is [issued](https://stripe.com/docs/issuing) cards. Related guide: [How to create…
16 properties 10 required
PostIssuingTokensTokenRequest
object
2 properties 1 required
GetIssuingCardholdersRequest
object
PostIssuingCardsRequest
object
11 properties 2 required
issuing.authorization
object
When an [issued card](https://stripe.com/docs/issuing) is used to make a purchase, an Issuing Authorization object is created. [Authorizations](https://stripe.…
25 properties 18 required
GetIssuingAuthorizationsAuthorizationRequest
object
GetIssuingSettlementsRequest
object
IssuingSettlementList
object
4 properties 4 required
GetIssuingCardsRequest
object
GetIssuingCardholdersCardholderRequest
object
PostIssuingTransactionsTransactionRequest
object
2 properties
IssuingNetworkTokenList
object
4 properties 4 required
IssuingCardholderList
object
4 properties 4 required
PostIssuingCardsCardRequest
object
6 properties
PostIssuingDisputesDisputeSubmitRequest
object
2 properties
issuing.settlement
object
When a non-stripe BIN is used, any use of an [issued card](https://stripe.com/docs/issuing) must be settled directly with the card network. The net amount owed…
16 properties 16 required
PostIssuingDisputesRequest
object
6 properties
GetIssuingTokensTokenRequest
object
PostIssuingDisputesDisputeRequest
object
4 properties
IssuingDisputeList
object
4 properties 4 required
error
object
An error response from the Stripe API
1 property 1 required
issuing.card
object
You can [create physical or virtual cards](https://stripe.com/docs/issuing/cards) that are issued to cardholders.
23 properties 14 required
PostIssuingSettlementsSettlementRequest
object
2 properties
PostIssuingCardholdersRequest
object
12 properties 2 required
issuing.token
object
An issuing token object is created when an issued card is added to a digital wallet. As a [card issuer](https://stripe.com/docs/issuing), you can [view and man…
12 properties 8 required
GetIssuingTransactionsTransactionRequest
object
GetIssuingTokensRequest
object
GetIssuingDisputesRequest
object
PostIssuingAuthorizationsAuthorizationApproveRequest
object
3 properties
GetIssuingDisputesDisputeRequest
object
PostIssuingAuthorizationsAuthorizationDeclineRequest
object
2 properties
GetIssuingCardsCardRequest
object
PostIssuingAuthorizationsAuthorizationRequest
object
2 properties
IssuingAuthorizationList
object
4 properties 4 required
GetIssuingSettlementsSettlementRequest
object
issuing.dispute
object
As a [card issuer](https://stripe.com/docs/issuing), you can dispute transactions that the cardholder does not recognize, suspects to be fraudulent, or has oth…
12 properties 10 required
GetIssuingTransactionsRequest
object
IssuingCardList
object
4 properties 4 required
GetIssuingAuthorizationsRequest
object

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

stripe-issuing-api-openapi.yml Raw ↑

Other APIs Stripe publishes across the network.

Stripe Accounts API
Stripe Balance API
Stripe Billing API
Stripe Charges API
Stripe Checkout API
Stripe Climate API
Stripe Country API
Stripe Coupons API
Stripe Credit Notes API
Stripe Customers API
Stripe Disputes API
Stripe Ephemeral Keys API
Where this information came from

This is an independent, third-party profile of Stripe Issuing API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.