# List all cards ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/issuing/cards: get: summary: List all cards deprecated: false description: >- 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. tags: - API Reference/Issuing/Cards parameters: - name: cardholder in: query description: Only return cards belonging to the Cardholder with the provided ID. required: false schema: type: string - name: type in: query description: >- Only return cards that have the given type. One of virtual or physical. required: false schema: type: string - name: limit in: query description: >- A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. required: false schema: type: string - name: created [gt] in: query description: Return results where the created field is greater than this value. required: false schema: type: string - name: created [gte] in: query description: >- Return results where the created field is greater than or equal to this value. required: false schema: type: string - name: created [lt] in: query description: Return results where the created field is less than this value. required: false schema: type: string - name: created [lte] in: query description: >- Return results where the created field is less than or equal to this value. required: false schema: type: string - name: ending_before in: query description: >- A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list. required: false schema: type: string - name: starting_after in: query description: >- A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list. required: false schema: type: string - name: exp_month in: query description: Only return cards that have the given expiration month. required: false schema: type: string - name: exp_year in: query description: Only return cards that have the given expiration year. required: false schema: type: string - name: last4 in: query description: Only return cards that have the given last four digits. required: false schema: type: string - name: status in: query description: >- Only return cards that have the given status. One of active, inactive, or canceled. required: false schema: type: string - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Content-Type in: header description: '' required: true example: application/json schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apifox-refs: 01HJ37G8779PY9XRP2WKNWWPW7: $ref: '#/components/schemas/List' x-apifox-overrides: data: &ref_0 type: array items: type: object x-apifox-refs: 01HJ37HZ934ZXG9RWCTTMFTF6M: $ref: '#/components/schemas/The%20Card%20object' x-apifox-overrides: replacement_reason: null replaced_by: null replacement_for: null shipping: null wallets: null number: null cvc: null x-apifox-orders: - 01HJ37HZ934ZXG9RWCTTMFTF6M properties: id: type: string description: Unique identifier for the object. cancellation_reason: type: string description: The reason why the card was canceled. enum: - lost - stolen - design_rejected x-apifox-enum: - name: '' value: lost description: The card was lost. - name: '' value: stolen description: The card was stolen. - name: '' value: design_rejected description: >- The design of this card was rejected by Wooshpay currency: type: string description: Three-letter ISO currency code. type: type: string description: The type of the card. enum: - virtual x-apifox-enum: - name: '' value: virtual description: No physical card will be printed. cardholder: description: The Cardholder object to which the card belongs. type: object x-apifox-refs: 01HTBRDQTR7C3Y5P119S5R60DF: &ref_1 $ref: >- #/components/schemas/The%20Cardholder%20object x-apifox-overrides: preferred_locales: null requirements: null x-apifox-orders: - 01HTBRDQTR7C3Y5P119S5R60DF properties: id: type: string description: Unique identifier for the object. object: type: string description: >- Value is "issuing.cardholder". String representing the object’s type. Objects of the same type share the same value. billing: type: object properties: address: type: object properties: city: type: string description: >- City, district, suburb, town, or village. country: type: string description: Two-letter country code line1: type: string description: Address line 1 line2: type: string description: Address line 2 postal_code: type: string description: ZIP or postal code. state: type: string description: State, county, province, or region. x-apifox-orders: - city - country - line1 - line2 - postal_code - state description: The cardholder’s billing address. x-apifox-ignore-properties: [] x-apifox-orders: - address description: The cardholder’s billing information. x-apifox-ignore-properties: [] name: type: string description: >- The cardholder’s name. This will be printed on cards issued to them. email: type: string description: The cardholder’s email address. phone_number: type: string description: >- The cardholder’s phone number. This is required for all cardholders who will be creating EU cards. metadata: type: array items: type: object properties: {} x-apifox-orders: [] x-apifox-ignore-properties: [] description: >- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. company: type: object properties: tax_id_provided: type: boolean description: >- Whether the company’s business ID number was provided. description: >- Additional information about a company cardholder. x-apifox-orders: - tax_id_provided x-apifox-ignore-properties: [] created: type: integer description: >- Time at which the object was created. Measured in seconds since the Unix epoch. individual: type: object properties: card_issuing: type: object properties: user_terms_acceptance: type: object properties: date: type: integer description: >- The Unix timestamp marking when the cardholder accepted the Authorized User Terms. Required for Celtic Spend Card users. ip: type: string description: >- The IP address from which the cardholder accepted the Authorized User Terms. Required for Celtic Spend Card users. user_agent: type: string description: >- The user agent of the browser from which the cardholder accepted the Authorized User Terms. x-apifox-orders: - date - ip - user_agent x-apifox-ignore-properties: [] x-apifox-orders: - user_terms_acceptance description: >- Information related to the card_issuing program for this cardholder. x-apifox-ignore-properties: [] dob: type: object properties: day: type: integer description: The day of birth, between 1 and 31. month: type: integer description: The month of birth, between 1 and 12. year: type: integer description: The four-digit year of birth. x-apifox-orders: - day - month - year description: The date of birth of this cardholder. x-apifox-ignore-properties: [] first_name: type: string description: >- The first name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters. last_name: type: string description: >- The last name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters. verification: type: object properties: document: type: object properties: back: type: string description: >- The back of a document returned by a file upload with a purpose value of identity_document. front: type: string description: >- The front of a document returned by a file upload with a purpose value of identity_document. x-apifox-orders: - back - front description: >- An identifying document, either a passport or local ID card. x-apifox-ignore-properties: [] x-apifox-orders: - document description: >- An identifying document, either a passport or local ID card. x-apifox-ignore-properties: [] description: >- Additional information about an individual cardholder. x-apifox-orders: - card_issuing - dob - first_name - last_name - verification x-apifox-ignore-properties: [] livemode: type: boolean description: >- Has the value true if the object exists in live mode or the value false if the object exists in test mode. spending_controls: type: object properties: spending_limits: type: object properties: amount: type: integer description: >- Maximum amount allowed to spend per interval. This amount is in the card’s currency and in the smallest currency unit. interval: type: string enum: - per_authorization - daily - weekly - monthly - yearly - all_time description: >- Interval (or event) to which the amount applies. x-apifox-enum: - value: per_authorization name: '' description: Limit applies to each authorization. - value: daily name: '' description: >- Limit applies to a day, starting at midnight UTC. - value: weekly name: '' description: >- Limit applies to a week, starting on Sunday at midnight UTC - value: monthly name: '' description: >- Limit applies to a month, starting on the 1st. - value: yearly name: '' description: >- Limit applies to a year, starting on January 1st. - value: all_time name: '' description: Limit applies to all transactions. description: >- Limit spending with amount-based rules that apply across this cardholder’s cards. x-apifox-orders: - amount - interval x-apifox-ignore-properties: [] spending_limits_currency: type: string description: >- Currency of the amounts within spending_limits. description: >- Rules that control spending across this cardholder’s cards. x-apifox-orders: - spending_limits - spending_limits_currency x-apifox-ignore-properties: [] status: type: string description: >- Specifies whether to permit authorizations on this cardholder’s cards. enum: - active - inactive - blocked x-apifox-enum: - value: active name: '' description: >- Cards attached to this cardholder can approve authorizations. - value: inactive name: '' description: >- Cards attached to this cardholder will decline all authorizations with the cardholder_inactive reason. - value: blocked name: '' description: >- Cards attached to this cardholder will decline all authorizations without an authorization object created. This status is non-reversible. type: type: string description: One of individual or company. enum: - individual - company x-apifox-enum: - value: individual name: '' description: >- The cardholder is a person, and additional information includes first and last name, date of birth. - value: company name: '' description: >- The cardholder is a company or business entity, and additional information includes their tax ID. x-apifox-ignore-properties: - id - object - billing - name - email - phone_number - metadata - company - created - individual - livemode - spending_controls - status - type exp_month: type: integer description: The expiration month of the card. exp_year: type: integer description: The expiration year of the card. first6: type: string description: The first 6 digits of the card number. binCode: type: string description: The first 6 digits of the card number. last4: type: string description: The last 4 digits of the card number. metadata: type: object properties: cardNick: type: string description: Identify the card nickname x-apifox-orders: - cardNick description: >- Set of key-value pairs that you can attach to an object. required: - cardNick x-apifox-ignore-properties: [] status: type: string description: >- Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to inactive. enum: - active - inactive - canceled x-apifox-enum: - name: '' value: active description: >- The card can approve authorizations. If the card is linked to a cardholder with past-due requirements, you may be unable to change the card’s status to ‘active’. - name: '' value: inactive description: >- The card will decline authorizations with the card_inactive reason. - name: '' value: canceled description: >- The card will decline authorizations, and no authorization object will be recorded. This status is permanent. object: type: string description: Value is "issuing.card" brand: type: string description: The brand of the card. created: type: string description: >- Time at which the object was created. Measured in seconds since the Unix epoch. livemode: type: boolean description: >- Has the value true if the object exists in live mode or the value false if the object exists in test mode. spending_controls: type: object properties: spending_limits: type: array items: type: object properties: amount: type: string description: >- Maximum amount allowed to spend per interval. interval: type: string description: >- Interval (or event) to which the amount applies. enum: - all_time - daily - monthly - yearly - per_authorization x-apifox-enum: - name: '' value: all_time description: Limit applies to all transactions. - name: '' value: daily description: >- Limit applies to a day, starting at midnight UTC. - name: '' value: monthly description: >- Limit applies to a month, starting on the 1st at midnight UTC. - name: '' value: yearly description: >- Limit applies to a year, starting on January 1st at midnight UTC. - name: '' value: per_authorization description: Limit applies to each authorization. x-apifox-orders: - amount - interval required: - amount - interval x-apifox-ignore-properties: [] description: >- Limit spending with amount-based rules that apply across any cards this card replaced spending_limits_currency: type: string description: >- Currency of the amounts within spending_limits. Always the same as the currency of the card. nullable: true description: >- Rules that control spending for this card. The all_time and per_authorization rules are required. x-apifox-orders: - spending_limits - spending_limits_currency required: - spending_limits x-apifox-ignore-properties: [] card_product_code: type: string description: >- The code representing a group of card features, such as currency, brand, bin code, supporting 3ds or not and so on. You can get them from open API [List all card bins]. required: - binCode - spending_controls x-apifox-ignore-properties: - id - cancellation_reason - currency - type - cardholder - exp_month - exp_year - first6 - binCode - last4 - metadata - status - object - brand - created - livemode - spending_controls - card_product_code x-apifox-orders: - 01HJ37G8779PY9XRP2WKNWWPW7 properties: object: type: string default: '"list"' url: type: string has_more: type: boolean data: *ref_0 x-apifox-ignore-properties: - object - url - has_more - data headers: {} x-apifox-name: OK security: - basic: [] x-apifox-folder: API Reference/Issuing/Cards x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/1296482/apis/api-133008102-run components: schemas: List: type: object properties: object: type: string default: '"list"' url: type: string has_more: type: boolean data: type: array items: type: object properties: id: type: string object: type: string api_version: type: 'null' application: type: 'null' created: type: integer description: type: string enabled_events: type: array items: type: string livemode: type: boolean metadata: type: object properties: {} x-apifox-orders: [] x-apifox-ignore-properties: [] status: type: string url: type: string x-apifox-orders: - id - object - api_version - application - created - description - enabled_events - livemode - metadata - status - url x-apifox-ignore-properties: [] x-apifox-orders: - object - url - has_more - data x-apifox-ignore-properties: [] x-apifox-folder: '' The Cardholder object: type: object properties: id: &ref_2 type: string description: Unique identifier for the object. object: &ref_3 type: string description: >- Value is "issuing.cardholder". String representing the object’s type. Objects of the same type share the same value. billing: type: object properties: address: type: object properties: city: &ref_4 type: string description: City, district, suburb, town, or village. country: &ref_5 type: string description: Two-letter country code line1: &ref_6 type: string description: Address line 1 line2: &ref_7 type: string description: Address line 2 postal_code: &ref_8 type: string description: ZIP or postal code. state: &ref_9 type: string description: State, county, province, or region. x-apifox-orders: &ref_10 - city - country - line1 - line2 - postal_code - state description: The cardholder’s billing address. x-apifox-ignore-properties: [] x-apifox-orders: &ref_11 - address description: The cardholder’s billing information. x-apifox-ignore-properties: [] name: &ref_12 type: string description: The cardholder’s name. This will be printed on cards issued to them. email: &ref_13 type: string description: The cardholder’s email address. phone_number: &ref_14 type: string description: >- The cardholder’s phone number. This is required for all cardholders who will be creating EU cards. metadata: type: array items: type: object properties: {} x-apifox-orders: &ref_15 [] x-apifox-ignore-properties: [] description: >- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. company: type: object properties: tax_id_provided: &ref_16 type: boolean description: Whether the company’s business ID number was provided. description: Additional information about a company cardholder. x-apifox-orders: &ref_17 - tax_id_provided x-apifox-ignore-properties: [] created: &ref_18 type: integer description: >- Time at which the object was created. Measured in seconds since the Unix epoch. individual: type: object properties: card_issuing: type: object properties: user_terms_acceptance: type: object properties: date: &ref_19 type: integer description: >- The Unix timestamp marking when the cardholder accepted the Authorized User Terms. Required for Celtic Spend Card users. ip: &ref_20 type: string description: >- The IP address from which the cardholder accepted the Authorized User Terms. Required for Celtic Spend Card users. user_agent: &ref_21 type: string description: >- The user agent of the browser from which the cardholder accepted the Authorized User Terms. x-apifox-orders: &ref_22 - date - ip - user_agent x-apifox-ignore-properties: [] x-apifox-orders: &ref_23 - user_terms_acceptance description: >- Information related to the card_issuing program for this cardholder. x-apifox-ignore-properties: [] dob: type: object properties: day: &ref_24 type: integer description: The day of birth, between 1 and 31. month: &ref_25 type: integer description: The month of birth, between 1 and 12. year: &ref_26 type: integer description: The four-digit year of birth. x-apifox-orders: &ref_27 - day - month - year description: The date of birth of this cardholder. x-apifox-ignore-properties: [] first_name: &ref_28 type: string description: >- The first name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters. last_name: &ref_29 type: string description: >- The last name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters. verification: type: object properties: document: type: object properties: back: &ref_30 type: string description: >- The back of a document returned by a file upload with a purpose value of identity_document. front: &ref_31 type: string description: >- The front of a document returned by a file upload with a purpose value of identity_document. x-apifox-orders: &ref_32 - back - front description: An identifying document, either a passport or local ID card. x-apifox-ignore-properties: [] x-apifox-orders: &ref_33 - document description: An identifying document, either a passport or local ID card. x-apifox-ignore-properties: [] description: Additional information about an individual cardholder. x-apifox-orders: &ref_34 - card_issuing - dob - first_name - last_name - verification x-apifox-ignore-properties: [] livemode: &ref_35 type: boolean description: >- Has the value true if the object exists in live mode or the value false if the object exists in test mode. spending_controls: type: object properties: spending_limits: type: object properties: amount: &ref_36 type: integer description: >- Maximum amount allowed to spend per interval. This amount is in the card’s currency and in the smallest currency unit. interval: type: string enum: &ref_37 - per_authorization - daily - weekly - monthly - yearly - all_time description: Interval (or event) to which the amount applies. x-apifox-enum: - value: per_authorization name: '' description: Limit applies to each authorization. - value: daily name: '' description: Limit applies to a day, starting at midnight UTC. - value: weekly name: '' description: >- Limit applies to a week, starting on Sunday at midnight UTC - value: monthly name: '' description: Limit applies to a month, starting on the 1st. - value: yearly name: '' description: Limit applies to a year, starting on January 1st. - value: all_time name: '' description: Limit applies to all transactions. description: >- Limit spending with amount-based rules that apply across this cardholder’s cards. x-apifox-orders: &ref_38 - amount - interval x-apifox-ignore-properties: [] spending_limits_currency: &ref_39 type: string description: Currency of the amounts within spending_limits. description: Rules that control spending across this cardholder’s cards. x-apifox-orders: &ref_40 - spending_limits - spending_limits_currency x-apifox-ignore-properties: [] status: type: string description: >- Specifies whether to permit authorizations on this cardholder’s cards. enum: &ref_41 - active - inactive - blocked x-apifox-enum: - value: active name: '' description: Cards attached to this cardholder can approve authorizations. - value: inactive name: '' description: >- Cards attached to this cardholder will decline all authorizations with the cardholder_inactive reason. - value: blocked name: '' description: >- Cards attached to this cardholder will decline all authorizations without an authorization object created. This status is non-reversible. type: type: string description: One of individual or company. enum: &ref_42 - individual - company x-apifox-enum: - value: individual name: '' description: >- The cardholder is a person, and additional information includes first and last name, date of birth. - value: company name: '' description: >- The cardholder is a company or business entity, and additional information includes their tax ID. preferred_locales: type: string description: >- The cardholder’s preferred locales (languages), ordered by preference. Locales can be de, en, es, fr, or it. This changes the language of the 3D Secure flow and one-time password messages sent to the cardholder. deprecated: true requirements: type: object properties: disabled_reason: type: string description: >- If disabled_reason is present, all cards will decline authorizations with cardholder_verification_required reason. enum: - listed - under_review - rejected.listed - requirements.past_due x-apifox-enum: - value: listed name: '' description: >- Account might be on a prohibited persons or companies list. The past_due field contains information that you need to provide before the cardholder can approve authorizations. - value: under_review name: '' description: >- This cardholder has raised additional review. Wooshpay will make a decision and update the disabled_reason field. - value: rejected.listed name: '' description: >- Cardholder is rejected because they are on a third-party prohibited persons or companies list (such as financial services provider or government). Their status will be blocked. - value: requirements.past_due name: '' description: >- Cardholder has outstanding requirements. The past_due field contains information that you need to provide before the cardholder can activate cards. past_due: type: string description: >- Array of fields that need to be collected in order to verify and re-enable the cardholder. enum: - individual.card_issuing.user_terms_acceptance.ip - individual.card_issuing.user_terms_acceptance.date - individual.first_name - individual.last_name - individual.dob.day - individual.dob.month - individual.dob.year - individual.verification.document - company.tax_id x-apifox-enum: - value: individual.card_issuing.user_terms_acceptance.ip name: '' description: >- The IP address from which the Cardholder accepted their Authorized User Terms. Required for Celtic Spend Card users. - value: individual.card_issuing.user_terms_acceptance.date name: '' description: >- The Unix timestamp marking when the Cardholder accepted their Authorized User Terms. Required for Celtic Spend Card users. - value: individual.first_name name: '' description: The cardholder’s legal first name. - value: individual.last_name name: '' description: The cardholder’s legal last name. - value: individual.dob.day name: '' description: The cardholder’s date of birth’s day. - value: individual.dob.month name: '' description: The cardholder’s date of birth’s month. - value: individual.dob.year name: '' description: The cardholder’s date of birth’s year. - value: individual.verification.document name: '' description: >- The front and back of a government-issued form of identification. - value: company.tax_id name: '' description: The cardholder’s business number (Tax ID). description: Information about verification requirements for the cardholder. x-apifox-orders: - disabled_reason - past_due deprecated: true x-apifox-ignore-properties: [] x-apifox-orders: - id - object - billing - name - email - phone_number - metadata - company - created - individual - livemode - spending_controls - status - type - preferred_locales - requirements x-apifox-ignore-properties: [] x-apifox-folder: '' The Card object: type: object properties: id: type: string description: Unique identifier for the object. cancellation_reason: type: string description: The reason why the card was canceled. enum: - lost - stolen - design_rejected x-apifox-enum: - name: '' value: lost description: The card was lost. - name: '' value: stolen description: The card was stolen. - name: '' value: design_rejected description: The design of this card was rejected by Wooshpay currency: type: string description: Three-letter ISO currency code. type: type: string description: The type of the card. enum: - virtual x-apifox-enum: - name: '' value: virtual description: No physical card will be printed. cardholder: description: The Cardholder object to which the card belongs. type: object x-apifox-refs: 01HTBRDQTR7C3Y5P119S5R60DF: *ref_1 x-apifox-orders: - 01HTBRDQTR7C3Y5P119S5R60DF properties: id: *ref_2 object: *ref_3 billing: type: object properties: address: type: object properties: city: *ref_4 country: *ref_5 line1: *ref_6 line2: *ref_7 postal_code: *ref_8 state: *ref_9 x-apifox-orders: *ref_10 description: The cardholder’s billing address. x-apifox-ignore-properties: [] x-apifox-orders: *ref_11 description: The cardholder’s billing information. x-apifox-ignore-properties: [] name: *ref_12 email: *ref_13 phone_number: *ref_14 metadata: type: array items: type: object properties: {} x-apifox-orders: *ref_15 x-apifox-ignore-properties: [] description: >- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. company: type: object properties: tax_id_provided: *ref_16 description: Additional information about a company cardholder. x-apifox-orders: *ref_17 x-apifox-ignore-properties: [] created: *ref_18 individual: type: object properties: card_issuing: type: object properties: user_terms_acceptance: type: object properties: date: *ref_19 ip: *ref_20 user_agent: *ref_21 x-apifox-orders: *ref_22 x-apifox-ignore-properties: [] x-apifox-orders: *ref_23 description: >- Information related to the card_issuing program for this cardholder. x-apifox-ignore-properties: [] dob: type: object properties: day: *ref_24 month: *ref_25 year: *ref_26 x-apifox-orders: *ref_27 description: The date of birth of this cardholder. x-apifox-ignore-properties: [] first_name: *ref_28 last_name: *ref_29 verification: type: object properties: document: type: object properties: back: *ref_30 front: *ref_31 x-apifox-orders: *ref_32 description: >- An identifying document, either a passport or local ID card. x-apifox-ignore-properties: [] x-apifox-orders: *ref_33 description: An identifying document, either a passport or local ID card. x-apifox-ignore-properties: [] description: Additional information about an individual cardholder. x-apifox-orders: *ref_34 x-apifox-ignore-properties: [] livemode: *ref_35 spending_controls: type: object properties: spending_limits: type: object properties: amount: *ref_36 interval: type: string enum: *ref_37 description: Interval (or event) to which the amount applies. x-apifox-enum: - value: per_authorization name: '' description: Limit applies to each authorization. - value: daily name: '' description: Limit applies to a day, starting at midnight UTC. - value: weekly name: '' description: >- Limit applies to a week, starting on Sunday at midnight UTC - value: monthly name: '' description: Limit applies to a month, starting on the 1st. - value: yearly name: '' description: Limit applies to a year, starting on January 1st. - value: all_time name: '' description: Limit applies to all transactions. description: >- Limit spending with amount-based rules that apply across this cardholder’s cards. x-apifox-orders: *ref_38 x-apifox-ignore-properties: [] spending_limits_currency: *ref_39 description: Rules that control spending across this cardholder’s cards. x-apifox-orders: *ref_40 x-apifox-ignore-properties: [] status: type: string description: >- Specifies whether to permit authorizations on this cardholder’s cards. enum: *ref_41 x-apifox-enum: - value: active name: '' description: >- Cards attached to this cardholder can approve authorizations. - value: inactive name: '' description: >- Cards attached to this cardholder will decline all authorizations with the cardholder_inactive reason. - value: blocked name: '' description: >- Cards attached to this cardholder will decline all authorizations without an authorization object created. This status is non-reversible. type: type: string description: One of individual or company. enum: *ref_42 x-apifox-enum: - value: individual name: '' description: >- The cardholder is a person, and additional information includes first and last name, date of birth. - value: company name: '' description: >- The cardholder is a company or business entity, and additional information includes their tax ID. x-apifox-ignore-properties: - id - object - billing - name - email - phone_number - metadata - company - created - individual - livemode - spending_controls - status - type exp_month: type: integer description: The expiration month of the card. exp_year: type: integer description: The expiration year of the card. first6: type: string description: The first 6 digits of the card number. binCode: type: string description: The first 6 digits of the card number. last4: type: string description: The last 4 digits of the card number. metadata: type: object properties: cardNick: type: string description: Identify the card nickname x-apifox-orders: - cardNick description: 'Set of key-value pairs that you can attach to an object. ' required: - cardNick x-apifox-ignore-properties: [] status: type: string description: >- Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to inactive. enum: - active - inactive - canceled x-apifox-enum: - name: '' value: active description: >- The card can approve authorizations. If the card is linked to a cardholder with past-due requirements, you may be unable to change the card’s status to ‘active’. - name: '' value: inactive description: >- The card will decline authorizations with the card_inactive reason. - name: '' value: canceled description: >- The card will decline authorizations, and no authorization object will be recorded. This status is permanent. object: type: string description: Value is "issuing.card" brand: type: string description: The brand of the card. created: type: string description: >- Time at which the object was created. Measured in seconds since the Unix epoch. cvc: type: string 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. Additionally, it’s only available via the “Retrieve a card” endpoint, not via “List all cards” or any other endpoint. This field is not included by default. To include it in the response, expand the cvc field. nullable: true livemode: type: boolean description: >- Has the value true if the object exists in live mode or the value false if the object exists in test mode. number: type: string 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. Additionally, it’s only available via the “Retrieve a card” endpoint, not via “List all cards” or any other endpoint. This field is not included by default. To include it in the response, expand the number field. nullable: true spending_controls: type: object properties: spending_limits: type: array items: type: object properties: amount: type: string description: Maximum amount allowed to spend per interval. interval: type: string description: Interval (or event) to which the amount applies. enum: - all_time - daily - monthly - yearly - per_authorization x-apifox-enum: - name: '' value: all_time description: Limit applies to all transactions. - name: '' value: daily description: Limit applies to a day, starting at midnight UTC. - name: '' value: monthly description: >- Limit applies to a month, starting on the 1st at midnight UTC. - name: '' value: yearly description: >- Limit applies to a year, starting on January 1st at midnight UTC. - name: '' value: per_authorization description: Limit applies to each authorization. x-apifox-orders: - amount - interval required: - amount - interval x-apifox-ignore-properties: [] description: >- Limit spending with amount-based rules that apply across any cards this card replaced spending_limits_currency: type: string description: >- Currency of the amounts within spending_limits. Always the same as the currency of the card. nullable: true description: >- Rules that control spending for this card. The all_time and per_authorization rules are required. x-apifox-orders: - spending_limits - spending_limits_currency required: - spending_limits x-apifox-ignore-properties: [] replacement_reason: type: string description: (未完成) The reason why the previous card needed to be replaced. enum: - lost - stolen - damaged - expired deprecated: true x-apifox-enum: - name: '' value: lost description: >- The card was lost. This status is only valid if the card it replaces is marked as lost. - name: '' value: stolen description: >- The card was stolen. This status is only valid if the card it replaces is marked as stolen. - name: '' value: damaged description: >- The physical card has been damaged and cannot be used at terminals. This reason is only valid for cards of type physical. - name: '' value: expired description: The expiration date has passed or is imminent. replaced_by: type: string description: (未完成) The latest card that replaces this card, if any. deprecated: true replacement_for: type: string description: (未完成) The card this card replaces, if any. deprecated: true shipping: type: object properties: address: type: object properties: city: type: string description: City, district, suburb, town, or village. country: type: string description: Two-letter country code line1: type: string description: Address line 1 line2: type: string description: Address line 2 postal_code: type: string description: ZIP or postal code. state: type: string description: State, county, province, or region. x-apifox-orders: - city - country - line1 - line2 - postal_code - state x-apifox-ignore-properties: [] carrier: type: string description: The delivery company that shipped a card. customs: type: object properties: eori_number: type: string x-apifox-orders: - eori_number x-apifox-ignore-properties: [] eta: type: string name: type: string phone_number: type: string require_signature: type: boolean service: type: string status: type: string tracking_number: type: string tracking_url: type: string type: type: string description: (未完成) Where and how the card will be shipped. x-apifox-orders: - address - carrier - customs - eta - name - phone_number - require_signature - service - status - tracking_number - tracking_url - type deprecated: true x-apifox-ignore-properties: [] wallets: type: object properties: {} description: >- (未完成) Information relating to digital wallets (like Apple Pay and Google Pay). x-apifox-orders: [] deprecated: true x-apifox-ignore-properties: [] card_product_code: type: string description: >- The code representing a group of card features, such as currency, brand, bin code, supporting 3ds or not and so on. You can get them from open API [List all card bins]. x-apifox-orders: - id - cancellation_reason - currency - type - cardholder - exp_month - exp_year - first6 - binCode - last4 - metadata - status - object - brand - created - cvc - livemode - number - spending_controls - replacement_reason - replaced_by - replacement_for - shipping - wallets - card_product_code required: - binCode - spending_controls x-apifox-ignore-properties: [] x-apifox-folder: '' securitySchemes: basic: type: http scheme: basic servers: - url: https://apitest.wooshpay.com description: 官网测试 security: - basic: [] ```