---
title: "Retrieve pending card authorizations"
method: GET
path: "/customers/{customerID}/card_accounts/{cardAccountID}/authorizations"
tags: ["Cards"]
---

# Retrieve pending card authorizations

`GET /customers/{customerID}/card_accounts/{cardAccountID}/authorizations`

Retrieve pending card authorizations.
Note: this endpoint is not paginated

## Path parameters

- `customerID` string, required — A UUID that uniquely identifies a resource
- `cardAccountID` string, required — A UUID that uniquely identifies a resource

## Query parameters

- `limit` integer
- `starting_time` string
- `ending_time` string
- `status` 'approved' | 'denied'

## Response `200`

Pending card authorizations

- object
  - `count` integer, required — The number of card authorizations returned
  - `data` CardAuthorization[], required
    - `id` string, required — A UUID that uniquely identifies a resource
    - `amount` string, required — The amount represented as a decimal string
    - `billing_amount` string — The billing amount, represented as a decimal string. The billing amount is the amount of the transaction excluding any additional hold. This amount should be present on all purchases, but will only differ from the amount field for some merchant categories in which an upcharge is involved (e.g. gas stations, hotels).
    - `currency` 'usd', required
    - `merchant_category_code` string, required — A merchant category code for card transactions (e.g., '5712')
    - `description` string, required — A description of the card transaction, including the merchant's name and location information
    - `authorized_at` string, required — Timestamp when the card transaction was authorized, in ISO8601 format
    - `details` object, required
      - `vendor_auth_id` string — ID in the vendor system used to identify this authorized card transaction
    - `local_transaction_details` CardLocalTransactionDetails — Details of a transaction processed in a local currency other than USD, with currency conversion applied
      - `amount` string, required — The amount in local currency, represented as a decimal string
      - `currency` string, required — The transaction's local currency
      - `exchange_rate` string, required — The exchange rate applied to convert the local currency amount into USD for the transaction
    - `verification_data` CardAuthorizationVerificationData — Information on verifications that were performed on information that the cardholder provided to the merchant.
      - `address_check` 'match' | 'not_provided' | 'mismatch' — Whether the cardholder provided an address and if it matched the cardholder’s address on file.
      - `address_postal_code_check` 'match' | 'not_provided' | 'mismatch' — Whether the cardholder provided a postal code and if it matched the cardholder’s postal code on file.
      - `cvv_check` 'match' | 'not_provided' | 'mismatch' — Whether the cardholder provided a CVV and if it matched the CVV on record.
      - `pin_check` 'verified' | 'failed' | 'locked' | 'not_set' | 'blocked' | 'no_pin_passed' | 'unknown' — Whether the cardholder provided a PIN and if it matched the PIN on record.
      - `three_d_secure_check` 'attempt_acknowledged' | 'authenticated' | 'failed' | 'required' — The results of the 3DS authentication attempt for this authorization, if applicable.
    - `stripe_issuing_authorization_id` string, nullable — The [Stripe Issuing authorization ID](https://docs.stripe.com/api/issuing/authorizations/object#issuing_authorization_object-id), if the authorization is backed by Stripe Issuing
    - `stripe_authorization_code` string, nullable — The network-assigned [authorization code](https://docs.corp.stripe.com/api/issuing/authorizations/object#issuing_authorization_object-request_history-authorization_code) for this request, if the authorization is backed by Stripe Issuing

## Other responses

- `401` — Missing or invalid API key
- `500` — Unexpected error. User may try and send the request again.

---

[API](https://skmtc.net/bridge/apis/bridge-api.md) · [All operations](https://skmtc.net/bridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bridge/bridge-api/revisions/570998bde3b5/schema)