List Limits

Use this endpoint to list spending limits with cursor-based pagination and optional filters. DELETED limits are not returned in listings.

GET /v1/limits

List Limits

cURL

curl --request GET \
  --url https://tracer.lerian.io/v1/limits \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <api-key>'

200

Example

{
  "limits": [
    {
      "limitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "maxAmount": "1000.00",
      "currency": "<string>",
      "scopes": [
        {
          "segmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "portfolioId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "merchantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "subType": "<string>"
        }
      ],
      "activeTimeStart": "09:00",
      "activeTimeEnd": "17:00",
      "customStartDate": "2023-11-07T05:31:56Z",
      "customEndDate": "2023-11-07T05:31:56Z",
      "resetAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "deletedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

Authorizations

ApiKeyAuthBearerAuth

X-API-Key · string · header · required

API Key authentication. Used by single-tenant deployments (MULTI_TENANT_ENABLED=false). Sent on every /v1/* request.

Headers

Content-Type · string · required

The type of media of the resource. Must be application/json.

X-API-Key · string · required

The API Key for authentication. This header is required for all endpoints except health checks.

X-Request-Id · string<uuid>

A unique identifier used to trace and track each request.

Query Parameters

limit · integer · default: 10

The maximum number of items to include in the response. Default: 10, Max: 100

Required range: 1 <= x <= 100

cursor · string

Pagination cursor from previous response.

name · string

Filter by limit name (exact match).

status · enum<string>

Filter by status (DRAFT, ACTIVE, INACTIVE). DELETED limits are not listable.

Available options: DRAFT, ACTIVE, INACTIVE

limit_type · enum<string>

Filter by limit type.

Available options: DAILY, WEEKLY, MONTHLY, CUSTOM, PER_TRANSACTION

account_id · string<uuid>

Filter by account ID (UUID).

segment_id · string<uuid>

Filter by segment ID (UUID).

portfolio_id · string<uuid>

Filter by portfolio ID (UUID).

merchant_id · string<uuid>

Filter by merchant ID (UUID).

transaction_type · enum<string>

Filter by transaction type.

Available options: CARD, WIRE, PIX, CRYPTO

sub_type · string

Filter by transaction subtype (e.g., debit, credit, prepaid).

Maximum string length: 50

sort_by · enum<string> · default: created_at

The field used to sort the results.

Available options: created_at, updated_at, name, max_amount

sort_order · enum<string> · default: DESC

The order used to sort the results.

Available options: ASC, DESC

Response

200

application/json

Indicates that the request was successful and the response contains the expected data.

Paginated list of spending limits.

limits · object[]

List of limit records.

Show child attributes

hasMore · boolean

Whether there are more results available.

nextCursor · string | null

Cursor for fetching the next page. Null if no more results.