# issuing.card From **Stripe API**. You can [create physical or virtual cards](https://stripe.com/docs/issuing/cards) that are issued to cardholders. - Type: `object` ## Properties ### `brand` - Required: true - Type: `string` - maxLength: `5000` The brand of the card. ### `cancellation_reason` - Required: false - Type: `string` - Nullable: true - Allowed values: `"lost"`, `"stolen"` The reason why the card was canceled. ### `cardholder` - Required: true - Type: `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 a Cardholder](https://stripe.com/docs/issuing/cards#create-cardholder) ### `created` - Required: true - Type: `integer` - Format: `unix-time` Time at which the object was created. Measured in seconds since the Unix epoch. ### `currency` - Required: true - Type: `string` Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). ### `cvc` - Required: false - Type: `string` - maxLength: `5000` The card's CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint. ### `exp_month` - Required: true - Type: `integer` The expiration month of the card. ### `exp_year` - Required: true - Type: `integer` The expiration year of the card. ### `id` - Required: true - Type: `string` - maxLength: `5000` Unique identifier for the object. ### `last4` - Required: true - Type: `string` - maxLength: `5000` The last 4 digits of the card number. ### `livemode` - Required: true - Type: `boolean` Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. ### `metadata` - Required: true - Type: `object` Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. ### `number` - Required: false - Type: `string` - maxLength: `5000` The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint. ### `object` - Required: true - Type: `string` - Allowed values: `"issuing.card"` String representing the object's type. Objects of the same type share the same value. ### `replaced_by` - Required: false - Nullable: true The latest card that replaces this card, if any. ### `replacement_for` - Required: false - Nullable: true The card this card replaces, if any. ### `replacement_reason` - Required: false - Type: `string` - Nullable: true - Allowed values: `"damaged"`, `"expired"`, `"lost"`, `"stolen"` The reason why the previous card needed to be replaced. ### `shipping` - Required: false - Nullable: true Where and how the card will be shipped. ### `spending_controls` - Required: true - Type: `object` ### `status` - Required: true - Type: `string` - Allowed values: `"active"`, `"canceled"`, `"inactive"` Whether authorizations can be approved on this card. ### `type` - Required: true - Type: `string` - Allowed values: `"physical"`, `"virtual"` The type of the card. ### `wallets` - Required: false - Nullable: true Information relating to digital wallets (like Apple Pay and Google Pay). ## JSON Schema ```json {"description":"You can [create physical or virtual cards](https://stripe.com/docs/issuing/cards) that are issued to cardholders.","properties":{"brand":{"description":"The brand of the card.","maxLength":5000,"type":"string"},"cancellation_reason":{"description":"The reason why the card was canceled.","enum":["lost","stolen"],"nullable":true,"type":"string"},"cardholder":{"$ref":"#/components/schemas/issuing.cardholder"},"created":{"description":"Time at which the object was created. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"currency":{"description":"Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).","type":"string"},"cvc":{"description":"The card's CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the [\"Retrieve a card\" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via \"List all cards\" or any other endpoint.","maxLength":5000,"type":"string"},"exp_month":{"description":"The expiration month of the card.","type":"integer"},"exp_year":{"description":"The expiration year of the card.","type":"integer"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"last4":{"description":"The last 4 digits of the card number.","maxLength":5000,"type":"string"},"livemode":{"description":"Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.","type":"boolean"},"metadata":{"additionalProperties":{"maxLength":500,"type":"string"},"description":"Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.","type":"object"},"number":{"description":"The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the [\"Retrieve a card\" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via \"List all cards\" or any other endpoint.","maxLength":5000,"type":"string"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["issuing.card"],"type":"string"},"replaced_by":{"anyOf":[{"maxLength":5000,"type":"string"},{"$ref":"#/components/schemas/issuing.card"}],"description":"The latest card that replaces this card, if any.","nullable":true,"x-expansionResources":{"oneOf":[{"$ref":"#/components/schemas/issuing.card"}]}},"replacement_for":{"anyOf":[{"maxLength":5000,"type":"string"},{"$ref":"#/components/schemas/issuing.card"}],"description":"The card this card replaces, if any.","nullable":true,"x-expansionResources":{"oneOf":[{"$ref":"#/components/schemas/issuing.card"}]}},"replacement_reason":{"description":"The reason why the previous card needed to be replaced.","enum":["damaged","expired","lost","stolen"],"nullable":true,"type":"string","x-stripeBypassValidation":true},"shipping":{"anyOf":[{"$ref":"#/components/schemas/issuing_card_shipping"}],"description":"Where and how the card will be shipped.","nullable":true},"spending_controls":{"$ref":"#/components/schemas/issuing_card_authorization_controls"},"status":{"description":"Whether authorizations can be approved on this card.","enum":["active","canceled","inactive"],"type":"string","x-stripeBypassValidation":true},"type":{"description":"The type of the card.","enum":["physical","virtual"],"type":"string"},"wallets":{"anyOf":[{"$ref":"#/components/schemas/issuing_card_wallets"}],"description":"Information relating to digital wallets (like Apple Pay and Google Pay).","nullable":true}},"required":["brand","cardholder","created","currency","exp_month","exp_year","id","last4","livemode","metadata","object","spending_controls","status","type"],"title":"IssuingCard","type":"object","x-expandableFields":["cardholder","replaced_by","replacement_for","shipping","spending_controls","wallets"],"x-resourceId":"issuing.card"} ```