# List Limits **Endpoint** `GET/v2/billing/limits` **Link** {% embed url="" %} ### **Request** #### **Query Parameters** | Parameter | Type | Description & Values | Required | Example | | ---------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------ | | **`currencyIsoFrom`** | `string` | Filter by **source currency** (ISO 4217). | No | `"USD"` | | **`currencyIsoTo`** | `string` | Filter by **target currency** (ISO 4217). | No | `"EUR"` | | **`customerId`** | `string` | Filter by **specific customer**. | No | `"cust_12345"` | | **`fromCreatedAt`** | `string` | Filter limits created **after** this date (ISO 8601). | No | `"2024-01-01T00:00:00Z"` | | **`fromUpdatedAt`** | `string` | Filter limits updated **after** this date (ISO 8601). | No | `"2024-05-01T00:00:00Z"` | | **`meta.page`** | `integer` | **Page number** (starts from 0). | No | `0` | | **`meta.pageSize`** | `integer` | **Items per page**. | No | `20` | | **`operationType`** | `string` |

Filter by operation type:
- NOTSET: Service type
- DEPOSIT
- TRANSFER
- WITHDRAW
- COMMISSION
- EXCHANGE
- CORRECTING

| No | `"TRANSFER"` | | **`paymentType`** | `string` |

Filter by payment method:
- EMPTY: Service type
- ACH
- FEDWIRE
- SWIFT
- CRYPTO
- EFT
- SEPA\_CT
- IMPS

| No | `"SWIFT"` | | **`toCreatedAt`** | `string` | Filter limits created **before** this date (ISO 8601). | No | `"2024-12-31T23:59:59Z"` | | **`toUpdatedAt`** | `string` | Filter limits updated **before** this date (ISO 8601). | No | `"2024-05-21T23:59:59Z"` | | **`withAllCustomers`** | `boolean` | Include **system-wide limits** (`true`) or customer-specific only (`false`). | No | `true` | #### **Headers** | Key | Value | Required | | --------------- | ------------------ | -------- | | `Authorization` | `Bearer ` | Yes | | `Accept` | `application/json` | Yes | *** ### **Response (200 OK)** Returns a paginated list of limit configurations. #### **Response Fields** **1. Meta Object** | Field | Type | Description | Example | | -------------- | --------- | ----------------------- | ------- | | **`pageSize`** | `integer` | Items per page. | `20` | | **`page`** | `integer` | Current page number. | `0` | | **`total`** | `string` | Total limits available. | `"150"` | **2. Limit Object (`items[]`)** | Field | Type | Description | Example | | --------------------- | --------- | ----------------------------------------- | ------------------------ | | **`id`** | `integer` | **Unique limit identifier**. | `101` | | **`owner`** | `integer` | **Owner ID** (system or customer). | `15` | | **`currencyIsoFrom`** | `string` | **Source currency** (ISO 4217). | `"USD"` | | **`currencyIsoTo`** | `string` | **Target currency** (ISO 4217). | `"EUR"` | | **`operationType`** | `string` | **Operation type** (see values above). | `"TRANSFER"` | | **`paymentType`** | `string` | **Payment method** (see values above). | `"SWIFT"` | | **`min`** | `number` | **Minimum amount** allowed. | `10.0` | | **`max`** | `number` | **Maximum amount** allowed. | `10000.0` | | **`createdAt`** | `string` | Creation timestamp (ISO 8601). | `"2024-01-15T10:30:00Z"` | | **`updatedAt`** | `string` | Last update timestamp (ISO 8601). | `"2024-05-20T14:45:00Z"` | | **`customerName`** | `string` | **Customer name** (if customer-specific). | `"John Doe"` | | **`customerId`** | `string` | **Customer ID** (if customer-specific). | `"cust_12345"` | **Example Response:** ```json { "items": [ { "id": 101, "owner": 15, "currencyIsoFrom": "USD", "currencyIsoTo": "EUR", "operationType": "TRANSFER", "paymentType": "SWIFT", "min": 50.0, "max": 5000.0, "createdAt": "2024-01-15T10:30:00Z", "updatedAt": "2024-05-20T14:45:00Z", "customerName": "John Doe", "customerId": "cust_12345" }, { "id": 102, "owner": 0, "currencyIsoFrom": "USD", "currencyIsoTo": "USD", "operationType": "WITHDRAW", "paymentType": "ACH", "min": 10.0, "max": 2500.0, "createdAt": "2024-02-01T09:00:00Z", "updatedAt": "2024-05-18T16:20:00Z", "customerName": "", "customerId": "" } ], "meta": { "pageSize": 20, "page": 0, "total": "45" } } ``` *** ### **Examples** #### **Request** ```bash curl -X GET 'https://stagep.tst-apidmndelss.com/v2/billing/limits?operationType=TRANSFER¤cyIsoFrom=USD&meta.page=0&meta.pageSize=10' \ -H 'Authorization: Bearer eyJhbGci...wNLGA' \ -H 'Accept: application/json' ``` #### **Request for Crypto Limits** ```bash curl -X GET 'https://stagep.tst-apidmndelss.com/v2/billing/limits?paymentType=CRYPTO&operationType=WITHDRAW&withAllCustomers=true' \ -H 'Authorization: Bearer eyJhbGci...wNLGA' \ -H 'Accept: application/json' ``` *** ### **Error Responses** 1. **Invalid Currency**: ```json { "error": "Invalid currency code: XYZ" } ``` 2. **Invalid Operation Type**: ```json { "error": "Invalid operation type: INVALID_TYPE" } ``` *** ### **Notes** * **System vs Customer Limits**: * `owner=0` indicates system-wide limits * `owner>0` indicates customer-specific limits * **Currency Pairs**: For single-currency operations, `currencyIsoFrom` and `currencyIsoTo` are the same. * **Empty Customer Fields**: System limits have empty `customerName` and `customerId`. * **Limit Hierarchy**: Customer-specific limits override system limits when both exist. Request sample ```postman_json Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOjE2NCwiZXhwIjoxNzYxNjQ2ODA3LCJrZXkiOiI1Y2ZiOGZjN2RmYjk4ZjVkYmIyZTgwNTVkZWFhN2U2Zjk4MzEyYmE3Iiwib3RwX3ZlcmlmaWVkIjpmYWxzZX0.yScbhwSz7crV6rjOolVsLBAO11vWEX8G57r0o7julFw currencyCodeFrom: USD currencyCodeTo: EUR customerId: D7k3xbc-ERrj-lde9k1t3XuaE fromCreatedAt: string fromUpdatedAt: ``` Response sample ```postman_json { "items": [ { "id": 1, "owner": 193, "currencyCodeFrom": "USD", "currencyCodeTo": "EUR", "operationType": "EXCHANGE", "paymentType": "EMPTY", "min": 100, "max": 100000, "createdAt": "2025-10-28T07:16:41Z", "updatedAt": "2025-10-28T07:16:41Z", "customerName": "SIRIUS SOLUTIONS LTD", "customerId": "D7k3xbc-ERrj-lde9k1t3XuaE" } ], "meta": { "pageSize": 1, "page": 0, "total": "1" } } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.delos.financial/limits/list-limits.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.