> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getlemma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get card

> Retrieve a card and its spending limits.

Returns a card, the spending limits set on it, and the merchants it may transact with.

Only cards your platform issued over the API are visible here. A card issued by the entity's staff in the Lemma app returns a 404.

## Path parameters

<ParamField path="card_id" type="string" required>
  The card's unique identifier.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique identifier for the card, prefixed with `card_`.
</ResponseField>

<ResponseField name="created_at" type="string">
  [ISO 8601](/api-reference/timestamps) timestamp of when the card was created.
</ResponseField>

<ResponseField name="entity_id" type="string">
  The ID of the entity that owns this card.
</ResponseField>

<ResponseField name="bank_account_id" type="string">
  The bank account this card draws from.
</ResponseField>

<ResponseField name="nickname" type="string | null">
  The human-readable label for this card.
</ResponseField>

<ResponseField name="last_4" type="string">
  The last 4 digits of the card number.
</ResponseField>

<ResponseField name="status" type="enum">
  The card's status.

  <Expandable title="Available options">
    <ResponseField name="active" type="string">
      The card can be used for payments.
    </ResponseField>

    <ResponseField name="disabled" type="string">
      The card is temporarily disabled.
    </ResponseField>

    <ResponseField name="canceled" type="string">
      The card is permanently canceled.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="authorization_controls" type="object">
  Every control restricting how this card can be used, including the ones Lemma
  applies to every card it issues.

  <Expandable title="Authorization controls object">
    <ResponseField name="usage" type="object">
      How many times this card can be used, and its controls.

      <Expandable title="Usage object">
        <ResponseField name="category" type="enum">
          Whether the card is for a single use or multiple uses.

          <Expandable title="Available options">
            <ResponseField name="multi_use" type="string">
              The card can be used for multiple authorizations. The only
              category issuable today.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="multi_use" type="object">
          Controls for multi-use cards.

          <Expandable title="Multi-use object">
            <ResponseField name="spending_limits" type="object[]">
              Every spending limit enforced on this card, including the ones
              Lemma applies automatically.

              <Expandable title="Limit object">
                <ResponseField name="interval" type="enum">
                  The window this limit is enforced over.

                  <Expandable title="Available options">
                    <ResponseField name="all_time" type="string">
                      Applies over the lifetime of the card.
                    </ResponseField>

                    <ResponseField name="per_transaction" type="string">
                      Applies to each individual transaction.
                    </ResponseField>

                    <ResponseField name="per_day" type="string">
                      Resets nightly at midnight UTC.
                    </ResponseField>

                    <ResponseField name="per_week" type="string">
                      Resets weekly on Mondays at midnight UTC.
                    </ResponseField>

                    <ResponseField name="per_month" type="string">
                      Resets on the first of the month at midnight UTC.
                    </ResponseField>
                  </Expandable>
                </ResponseField>

                <ResponseField name="amount" type="integer">
                  Cap in cents.
                </ResponseField>

                <ResponseField name="merchant_category_codes" type="string[] | null">
                  Merchant category codes this limit applies to. `null` applies
                  to all merchants.
                </ResponseField>
              </Expandable>
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="merchant_acceptor_identifier" type="object | null">
      Restricts which Merchant Acceptor IDs this card may transact with. `null`
      when this dimension is unrestricted.

      <Expandable title="Merchant acceptor identifier object">
        <ResponseField name="allowed" type="string[] | null">
          The only Merchant Acceptor IDs this card may transact with. `null`
          when this dimension is not an allow list.
        </ResponseField>

        <ResponseField name="blocked" type="string[] | null">
          Merchant Acceptor IDs this card may never transact with. `null` when
          this dimension is not a block list.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="merchant_category_code" type="object | null">
      Restricts which merchant categories this card may transact with, including
      the categories Lemma blocks on every card it issues. `null` when this
      dimension is unrestricted.

      <Expandable title="Merchant category code object">
        <ResponseField name="allowed" type="string[] | null">
          The only merchant category codes this card may transact with. `null`
          when this dimension is not an allow list.
        </ResponseField>

        <ResponseField name="blocked" type="string[] | null">
          Merchant category codes this card may never transact with. `null` when
          this dimension is not a block list.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="merchant_country" type="object | null">
      Restricts which merchant countries this card may transact with, as [ISO
      3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) codes.
      `null` when this dimension is unrestricted.

      <Expandable title="Merchant country object">
        <ResponseField name="allowed" type="string[] | null">
          The only merchant countries this card may transact with. `null` when
          this dimension is not an allow list.
        </ResponseField>

        <ResponseField name="blocked" type="string[] | null">
          Merchant countries this card may never transact with. `null` when this
          dimension is not a block list.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "card_Bx5nTm8hKw3pVd7c",
    "created_at": "2026-07-28T18:45:00Z",
    "entity_id": "entity_k7mXp2vR9nTfBw4s",
    "bank_account_id": "account_maple_ridge_cigna_01",
    "nickname": "Acme ops card",
    "last_4": "4242",
    "status": "active",
    "authorization_controls": {
      "usage": {
        "category": "multi_use",
        "multi_use": {
          "spending_limits": [
            { "interval": "per_transaction", "amount": 25000, "merchant_category_codes": null },
            { "interval": "per_day", "amount": 100000, "merchant_category_codes": null },
            { "interval": "per_day", "amount": 300000, "merchant_category_codes": ["6010", "6011"] }
          ]
        }
      },
      "merchant_acceptor_identifier": null,
      "merchant_category_code": { "allowed": null, "blocked": ["7995", "6051"] },
      "merchant_country": null
    }
  }
  ```

  ```json 404 theme={null}
  {
    "statusCode": 404,
    "error": "Not found",
    "message": "Card not found"
  }
  ```
</ResponseExample>