# List all cards for a business

Returns all cards associated with the business specified in the request URL.

Endpoint: GET /v1/businesses/{business_id}/cards
Version: 1.0

## Path parameters:

  - `business_id` (string, required)

## Query parameters:

  - `page[number]` (integer)
    The number of results pages to return.

  - `page[size]` (integer)
    The size of each page in the response.

## Response 200 fields (application/json):

  - `id` (string)
    ID of the card.
    Example: "8febdba4912a747808ccc6f95f82bbb4"

  - `status` (string)
    The current status of the card.
    Enum: "ACTIVE", "ACTIVATION_BLOCKED_BY_SOLARIS", "BLOCKED", "BLOCKED_BY_SOLARIS", "CLOSED", "CLOSED_BY_SOLARIS", "COUNTERFEIT_CARD", "FRAUD", "INACTIVE", "LOST", "NEVER_RECEIVED", "PROCESSING", "STOLEN"

  - `reference` (string)
    Unique reference number for the card.
    Example: "87285d83-ab15-4906-af87-5763801d9e43"

  - `type` (string)
    The type of the card.  The following enum list is not exhaustive but only indicative of some possible values.
    Enum: "MASTERCARD_DEBIT", "MASTERCARD_BUSINESS_DEBIT", "VIRTUAL_MASTERCARD_DEBIT", "VIRTUAL_MASTERCARD_BUSINESS_DEBIT", "VIRTUAL_MASTERCARD_FREELANCE_DEBIT", "VISA_DEBIT", "VISA_BUSINESS_DEBIT", "VIRTUAL_VISA_DEBIT", "VIRTUAL_VISA_BUSINESS_DEBIT", "VIRTUAL_VISA_FREELANCE_DEBIT", "VISA_CREDIT", "VIRTUAL_VISA_CREDIT", "VISA_BUSINESS_CREDIT", "VIRTUAL_VISA_BUSINESS_CREDIT"

  - `expiration_date` (string)
    The expiration date of the card.
    Example: "2020-12-30"

  - `new_card_ordered` (boolean)
    Boolean that indicates if a new physical card was ordered for this card resource (either for the first time or as a replacement).

  - `person_id` (string)
    ID of the cardholder person resource.
    Example: "5af2ea4271038d5c53e68ccbf4fe43b3cper"

  - `account_id` (string)
    ID of the account to which the card is tied.
    Example: "a5844f601567db9b59b3531245a58e96cacc"

  - `business_id` (string)
    (For business cards) ID of the business with which the card is associated.
    Example: "52e6a9b8a559d842ed7d8901b0e1bf4bcbiz"

  - `representation` (object)
    Object containing information about the cardholder, the card's masked PAN, and the formatted expiration date.

  - `representation.line_1` (string)
    The cardholder's first and last name.
    Example: "SLY STALLONE"

  - `representation.line_2` (string)
    The supplementary personalized info like business name or membership number.
    Example: "BUSINESS NAME"

  - `representation.masked_pan` (string)
    The first six and last four digits of the card.
    Example: "537458******4567"

  - `representation.formatted_expiration_date` (string)
    The card's expiration date in MM/YY format.
    Example: "09/22"

  - `creation_date` (string)
    Date when the latest plastic card for this card resource was created.
    Example: "2022-05-01"

  - `sia_account_number` (string)
    The SIA account number for the card.
    Example: "500001650679"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `detail` (string)
    Example: "Partner configuration for 1333d41bdc314436b9448c24ae42eccpar not found."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."