Sign in
Card spending controls

Index card controls lists

Returns an array containing all active card controls lists in place for your customers.

get/v1/card_controls/lists

Query parameters

filter[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.

Filter the results by the type of scope.

filter[scope_id]string

Filter the results by a specific scope (e.g., the ID of an account or the person ID of a cardholder).

include_relatedboolean

Using this filter, the API will return all card controls lists that were defined at the ACCOUNT, BUSINESS, or PARTNER level that apply to a specific card. You can only use this filter in combination with the scope and scope_id filters. The scope must be set to CARD and the scope_id must be set to a card ID.

Response

Successful result of the operation

idstring 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_idstring 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_keystring uuid required

A randomly generated UUID which the server uses to recognize subsequent retries of the same request.

Example response

[
  {
    "id": "7a911b90-0109-11ec-9a03-0242ac130003",
    "scope_id": "54e06604b0cf825810bec508cc1f2dc7mcrd",
    "idempotency_key": "504f6816-f7b5-4965-bc35-69acadc9f5c7",
    "inclusion": {
      "dimension": [
        "5411"
      ]
    },
    "exclusion": {
      "dimension": [
        "5411"
      ]
    }
  }
]