Skip to main content

Get Detailed Information for a Card

GET 
/api/v1/cards/card/details

Retrieves detailed information for a specific card, including masked data for security.

Request​

Query Parameters

    card_id Card Id

    The unique identifier of the card for which details are being requested.

Responses​

Successful Response

Schema
    cardholder_id object
    anyOf

    string

    form_factor CardFormFactorrequired

    Possible values: [physical, virtual]

    An enumeration.

    card_id object required
    anyOf

    string

    created_at Created Atrequired
    closed_at Closed At
    mask_number Mask Numberrequired
    nick_name Nick Name
    status Status
    brand Brandrequired
    settings object
    active_from Active From

    The starting datetime from which card transactions will be authorized. Transactions attempted before this time are automatically rejected.

    active_to Active To

    The ending datetime until which card transactions will be authorized. Transactions attempted after this time are automatically rejected.

    allowed_currencies Allowed Currencies

    A list of currencies in which transactions are permitted. If this field is absent, null, or an empty array, transactions in all currencies are allowed.

    allowed_transaction_count object

    An enumeration.

    limits object[]

    Transaction limits based on interval and amount. If no limits are set, will be used next values: PER_TRANSACTION - 1000 USD, DAILY - 5000 USD.

  • Array [
    • interval object

    An enumeration.

    amount Amountrequired

    The maximum amount allowed for the specified interval.

  • ]
    • bin object
    vendor Providersrequired

    Possible values: [airwallex, sunrate, wex, connex, matchmove]

    An enumeration.

    code Code

    The specific code of the BIN.

    vendor_code Vendor Code
    purpose BinPurposeEnum[]

    Possible values: [CARDS_VIRTUAL, SHARED_BALANCE_VIRTUAL_CARDS]

    issue Issue
    topup Topup
    withdrawal Withdrawal
    tariff_data object
    paymentServices PayServices[]

    Possible values: [GooglePay, ApplePay, SamsungPay]

    An optional list of payment services supported by this BIN, such as mobile payment platforms like Google Pay or Apple Pay.

    merchants string[]

    An optional list of merchant names that are specifically allowed to process payments using this BIN.

    isTokenizable Istokenizable

    Indicates if the BIN is tokenizable.

    scheme object

    An enumeration.

    address_id object

    The unique identifier of the address associated with the BIN.

    anyOf

    string

    currency_id object

    The unique identifier of the currency associated with the BIN.

    anyOf

    string

    id object required

    The unique identifier of the BIN.

    anyOf

    string

    address object
    country objectrequired
    name Namerequired
    iso_code Iso Coderequired
    city Cityrequired
    line_1 Line 1required
    line_2 Line 2required
    postal_code Postal Coderequired
    currency object
    iso_code Iso Coderequired
    digital_code Digital Coderequired
    balance object
    card_id object required

    The unique identifier of the card.

    anyOf

    string

    limit Limitrequired

    The total spending limit of the card, applicable over the card's lifetime.

    available Availablerequired

    The current available spending limit on the card. Calculated as available' = 'limit' - 'used'.

    used Usedrequired

    The total amount that has been used from the card. This is equivalent to the 'spend' amount in other endpoints.

    opening_balance Opening Balancerequired

    The balance of the card at the time of its issuance.

    topup_balance Topup Balancerequired

    The total amount added to the card through top-ups.

    limit_per_transaction Limit Per Transactionrequired

    The maximum limit allowed for a single transaction.

    pending_balance Pending Balancerequired

    The total amount in transactions that are currently pending.

    fees_balance Fees Balancerequired

    The total sum of fees charged to the card.

    incoming_balance Incoming Balancerequired

    The total amount of external payments received on the card. Currently not supported.

    withdrawal_balance Withdrawal Balancerequired

    The total amount withdrawn from the card, including limit decrease operations.

    is_autolimit Is Autolimit

    Default value: true

    is_withdrawable Is Withdrawable

    Default value: true

    is_tokenizable Is Tokenizable

    Default value: false

Loading...