---
title: "Retrieve a card controls list"
method: GET
path: "/v1/card_controls/lists/{id}"
tags: ["Card spending controls"]
---

# Retrieve a card controls list

`GET /v1/card_controls/lists/{id}`

Returns the card controls list with the ID specified in the request URL.

## Path parameters

- `id` string, required

## Response `200`

The operation was successful.

- CardControlListResponse
  - `id` string, required — ID of the created card controls list.
  - `scope` 'CARD' | 'CARDHOLDER' | 'ACCOUNT' | 'BUSINESS' | 'PARTNER' | 'PARTNER_CARDS' | 'BUSINESS_CARDS' | 'ACCOUNT_CARDS' | 'CARDHOLDER_CARDS' | 'NON_BUSINESS_CARDS' | 'PARTNER_CARDHOLDERS', required — The scope of the card spending control.
  - `scope_id` string, required — ID of the resource that corresponds with the `scope`. For example, if the `scope` is `PARTNER`, then the `scope_id` would be your partner ID. For `business`, it would be the business ID.
  - `origin` 'SOLARISBANK' | 'PARTNER', required — Indicates whether the card spending control was created by Solaris SE or by you.
  - `idempotency_key` string, uuid, required — A randomly generated UUID which the server uses to recognize subsequent retries of the same request.
  - `inclusion` ListRule
    - `type` 'MERCHANT_CATEGORY' | 'POS_ENTRY_MODE' | 'TRANSACTION_TYPE' | 'MERCHANT_COUNTRY' | 'ACQUIRER_ID' | 'MERCHANT_ID' | 'ALL_TYPES', required — The type of transactions to be included/excluded.
    - `dimension` string[], required — The dimension of transactions to be included/excluded.
  - `exclusion` ListRule
    - `type` 'MERCHANT_CATEGORY' | 'POS_ENTRY_MODE' | 'TRANSACTION_TYPE' | 'MERCHANT_COUNTRY' | 'ACQUIRER_ID' | 'MERCHANT_ID' | 'ALL_TYPES', required — The type of transactions to be included/excluded.
    - `dimension` string[], required — The dimension of transactions to be included/excluded.

## Other responses

- `400` — Partner identifier is invalid
- `403` — You are not authorized to perform this action.
- `404` — The card controls list could not be found.
- `500` — Internal server error.

---

[API](https://skmtc.net/solarisgroup/apis/card-creation-servicing.md) · [All operations](https://skmtc.net/solarisgroup/apis/card-creation-servicing/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/card-creation-servicing/revisions/a772504dcc9e/schema)