# List Client Operations **Endpoint** `GET/v2/billing/operation` **Link** {% embed url="" %} ### **Request** #### **Query Parameters** | Parameter | Type | Description & Values | Required | Example | | ---------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------ | | **`account`** | `string` | Filter by account ID or number. | No | `"acc_12345"` | | **`clientCuid`** | `string` | Filter by client customer ID. | No | `"cust_67890"` | | **`clientName`** | `string` | Filter by client name (partial match). | No | `"John"` | | **`counterpartySuid`** | `string` | Filter by counterparty SUID. | No | `"suid_abc123"` | | **`destination`** | `string` | Filter by destination account. | No | `"dest_account"` | | **`fromCreatedAt`** | `string` | Filter operations created **after** this date (ISO 8601). | No | `"2024-01-01T00:00:00Z"` | | **`fromUpdatedAt`** | `string` | Filter operations 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` | | **`opid`** | `string` | Filter by specific operation ID. | No | `"op_12345"` | | **`recipientId`** | `string` | Filter by recipient ID. | No | `"rec_67890"` | | **`recipientName`** | `string` | Filter by recipient name. | No | `"Jane Smith"` | | **`senderId`** | `string` | Filter by sender ID. | No | `"send_12345"` | | **`senderName`** | `string` | Filter by sender name. | No | `"John Doe"` | | **`source`** | `string` | Filter by source account. | No | `"src_account"` | | **`status`** | `string` |

Filter by operation status:
- NEW: Created by user/moderator
- PENDING: Moderator approved
- WORKING: Processing by network
- SUCCESS: Completed
- FAIL: Failed
- CANCELED: Canceled

| No | `"SUCCESS"` | | **`toCreatedAt`** | `string` | Filter operations created **before** this date (ISO 8601). | No | `"2024-12-31T23:59:59Z"` | | **`toUpdatedAt`** | `string` | Filter operations updated **before** this date (ISO 8601). | No | `"2024-05-21T23:59:59Z"` | | **`type`** | `string` |

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

| No | `"TRANSFER"` | #### **Headers** | Key | Value | Required | | --------------- | ------------------ | -------- | | `Authorization` | `Bearer ` | Yes | | `Accept` | `application/json` | Yes | *** ### **Response (200 OK)** Returns a paginated list of operations with detailed information. #### **Response Fields** **1. Meta Object** | Field | Type | Description | Example | | -------------- | --------- | --------------------------- | ------- | | **`pageSize`** | `integer` | Items per page. | `20` | | **`page`** | `integer` | Current page number. | `0` | | **`total`** | `string` | Total operations available. | `"250"` | **2. Operation Object (`items[]`)** | Field | Type | Description | Example | | ----------------------- | --------- | -------------------------------------- | ------------------------ | | **`opid`** | `string` | **Unique operation ID**. | `"op_12345"` | | **`isVisible`** | `boolean` | **Visibility status**. | `true` | | **`status`** | `string` | **Current status** (see values above). | `"SUCCESS"` | | **`type`** | `string` | **Operation type** (see values above). | `"TRANSFER"` | | **`paymentType`** | `string` | **Payment method**. | `"SWIFT"` | | **`createdAt`** | `string` | Creation timestamp (ISO 8601). | `"2024-05-20T10:30:00Z"` | | **`updatedAt`** | `string` | Last update timestamp (ISO 8601). | `"2024-05-20T14:45:00Z"` | | **`source`** | `object` | **Source details** (see below). | - | | **`destination`** | `object` | **Destination details** (see below). | - | | **`sourceAmount`** | `object` | **Source amount** (Money Object). | - | | **`destinationAmount`** | `object` | **Destination amount** (Money Object). | - | | **`commissionAmount`** | `object` | **Commission amount** (Money Object). | - | | **`comment`** | `string` | **Operation comment/notes**. | `"Monthly payment"` | | **`reference`** | `string` | **Reference number**. | `"REF202405201234"` | | **`isParent`** | `boolean` | **Parent operation flag**. | `true` | | **`customer`** | `object` | **Customer details** (see below). | - | | **`documents`** | `array` | **Associated documents** (see below). | - | **3. Source/Destination Objects** Contains nested objects for: * **`account`**: Account details (id, name, number, customer) * **`counterpartyAccount`**: Counterparty details with bank information * **`customer`**: Customer information (cuid, name, type) **4. Money Object** Used in `sourceAmount`, `destinationAmount`, `commissionAmount`: | Field | Type | Description | Example | | ------------------ | --------- | ------------------------- | --------------------- | | **`currencyCode`** | `string` | Currency code (ISO 4217). | `"USD"` | | **`units`** | `string` | Whole units. | `"1000"` | | **`nanos`** | `integer` | Fractional units (10^-9). | `500000000` (= $0.50) | **5. Document Object** | Field | Type | Description | Example | | -------------- | --------- | ----------------------------------------- | ------------------------ | | **`guid`** | `string` | **Document unique ID**. | `"doc_abc123"` | | **`fileName`** | `string` | **Original filename**. | `"invoice.pdf"` | | **`size`** | `integer` | **File size in bytes**. | `1024000` | | **`mime`** | `string` | **MIME type**. | `"application/pdf"` | | **`docType`** | `string` | **Document type** (see values in sample). | `"BANK_STATEMENT"` | | **`createAt`** | `string` | **Upload timestamp**. | `"2024-05-20T11:00:00Z"` | **Example Response:** ```json { "meta": { "pageSize": 20, "page": 0, "total": "45" }, "items": [ { "opid": "op_12345", "isVisible": true, "status": "SUCCESS", "type": "TRANSFER", "paymentType": "SWIFT", "createdAt": "2024-05-20T10:30:00Z", "updatedAt": "2024-05-20T14:45:00Z", "source": { "account": { "id": "acc_12345", "name": "Business Account", "number": "ACC001", "customer": { "cuid": "cust_67890", "name": "Acme Inc.", "type": "CORPORATE" } } }, "destination": { "counterpartyAccount": { "id": "cpa_78901", "name": "Supplier Account", "number": "IBAN123456789", "counterparty": { "suid": "suid_abc123", "name": "Global Suppliers Ltd", "bankName": "International Bank", "bankAddress": { "addressLine1": "123 Main Street", "city": "London", "countryIso": "GB", "postalCode": "SW1A 1AA" } } } }, "sourceAmount": { "sum": { "currencyCode": "USD", "units": "5000", "nanos": 0 } }, "destinationAmount": { "sum": { "currencyCode": "EUR", "units": "4600", "nanos": 0 } }, "commissionAmount": { "sum": { "currencyCode": "USD", "units": "25", "nanos": 0 } }, "comment": "Q2 supplier payment", "reference": "REF202405201234", "isParent": true, "customer": { "cuid": "cust_67890", "name": "Acme Inc.", "type": "CORPORATE" }, "documents": [] } ] } ``` *** ### **Examples** #### **Request** ```bash curl -X GET 'https://stagep.tst-apidmndelss.com/v2/billing/operation?status=SUCCESS&type=TRANSFER&meta.page=0&meta.pageSize=10' \ -H 'Authorization: Bearer eyJhbGci...wNLGA' \ -H 'Accept: application/json' ``` #### **Request with Date Range** ```bash curl -X GET 'https://stagep.tst-apidmndelss.com/v2/billing/operation?fromCreatedAt=2024-05-01T00:00:00Z&toCreatedAt=2024-05-21T23:59:59Z&status=SUCCESS' \ -H 'Authorization: Bearer eyJhbGci...wNLGA' \ -H 'Accept: application/json' ``` *** ### **Error Responses** 1. **Invalid Date Format**: ```json { "error": "Invalid date format for fromCreatedAt" } ``` 2. **Unauthorized**: ```json { "error": "Unauthorized" } ``` *** ### **Notes** * **Status Flow**: `NEW` → `PENDING` → `WORKING` → `SUCCESS/FAIL/CANCELED` * **Money Precision**: Use `units` + `nanos` for precise amounts (e.g., $100.50 = units="100", nanos=500000000) * **Document Types**: Various document types supported for compliance and verification * **Pagination**: Use for large datasets to manage performance Request sample ```postman_json Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOjE2NCwiZXhwIjoxNzYxNjUzMTMxLCJrZXkiOiI1Y2ZiOGZjN2RmYjk4ZjVkYmIyZTgwNTVkZWFhN2U2Zjk4MzEyYmE3Iiwib3RwX3ZlcmlmaWVkIjpmYWxzZX0.f9GPGrvNiPbn3PZGwTJZQHsM_b_4HH4GxlJzrO-YO68 account: UjmLCEcZCXzb counterpartyAccountId: string customerId: D7k3xbc-ERrj-lde9k1t3XuaE customerName: string destination: string fromCreatedAt: string fromUpdatedAt: string meta.page: integer meta.pageSize: integer operationId: string recipientId: string recipientName: string senderId: string senderName: string source: string status: Not SetNOT_SETNEWPENDINGWORKINGSUCCESSFAILCANCELED select an option toCreatedAt: string toUpdatedAt: string type: Not SetNOTSETDEPOSITTRANSFERWITHDRAWCOMMISSIONEXCHANGE select an option ``` Response sample ```postman_json { "meta": { "pageSize": 8, "page": 0, "total": "8" }, "items": [ { "operationId": "290bf59e-a1b5-4a1d-89c1-ce44c2e28246", "isVisible": false, "status": "PENDING", "type": "COMMISSION", "paymentType": "EMPTY", "createdAt": "2025-10-20T09:56:08Z", "updatedAt": "2025-10-20T09:58:08Z", "source": { "account": { "id": "UjmLCEcZCXzb", "name": "USD", "number": "", "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" } } }, "destination": { "account": { "id": "UcJlzOBpEhCE", "name": "Commission Account USD", "number": "", "customer": { "id": "Dnewcvn-euuI-vG0FZCRDjLXS", "name": "Test Eugen Test Eugen", "type": "CORPORATE" } } }, "sourceAmount": { "sum": { "currencyCode": "USD", "units": "12", "nanos": 99999999 }, "default": { "currencyCode": "USD", "units": "12", "nanos": 99999999 } }, "destinationAmount": { "sum": { "currencyCode": "USD", "units": "12", "nanos": 99999999 }, "default": { "currencyCode": "USD", "units": "12", "nanos": 99999999 } }, "commissionAmount": { "sum": { "currencyCode": "USD", "units": "0", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "0", "nanos": 0 } }, "comment": "Commission for operation: b5b1874a-4df1-453a-b28e-7521e8b38fd6", "reference": "", "isParent": false, "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" }, "documents": [] }, { "operationId": "b5b1874a-4df1-453a-b28e-7521e8b38fd6", "isVisible": true, "status": "PENDING", "type": "TRANSFER", "paymentType": "EMPTY", "createdAt": "2025-10-20T09:56:08Z", "updatedAt": "2025-10-20T09:58:08Z", "source": { "account": { "id": "UjmLCEcZCXzb", "name": "USD", "number": "", "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" } } }, "destination": { "account": { "id": "UnLHMfwnumW7", "name": "USD DELOS", "number": "", "customer": { "id": "Dnewcvn-euuI-vG0FZCRDjLXS", "name": "Test Eugen Test Eugen", "type": "CORPORATE" } } }, "sourceAmount": { "sum": { "currencyCode": "USD", "units": "10", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "10", "nanos": 0 } }, "destinationAmount": { "sum": { "currencyCode": "USD", "units": "10", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "10", "nanos": 0 } }, "commissionAmount": { "sum": { "currencyCode": "USD", "units": "12", "nanos": 99999999 }, "default": { "currencyCode": "USD", "units": "12", "nanos": 99999999 } }, "comment": "Test", "reference": "", "isParent": false, "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" }, "documents": [] }, { "operationId": "7c7d8aac-d492-49f0-9579-60aa849262d8", "isVisible": false, "status": "PENDING", "type": "COMMISSION", "paymentType": "EMPTY", "createdAt": "2025-10-20T09:53:28Z", "updatedAt": "2025-10-20T09:55:29Z", "source": { "account": { "id": "UjmLCEcZCXzb", "name": "USD", "number": "", "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" } } }, "destination": { "account": { "id": "UcJlzOBpEhCE", "name": "Commission Account USD", "number": "", "customer": { "id": "Dnewcvn-euuI-vG0FZCRDjLXS", "name": "Test Eugen Test Eugen", "type": "CORPORATE" } } }, "sourceAmount": { "sum": { "currencyCode": "USD", "units": "12", "nanos": 99999999 }, "default": { "currencyCode": "USD", "units": "12", "nanos": 99999999 } }, "destinationAmount": { "sum": { "currencyCode": "USD", "units": "12", "nanos": 99999999 }, "default": { "currencyCode": "USD", "units": "12", "nanos": 99999999 } }, "commissionAmount": { "sum": { "currencyCode": "USD", "units": "0", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "0", "nanos": 0 } }, "comment": "Commission for operation: 3430ee63-42cb-4f4e-a387-a6de9516109c", "reference": "", "isParent": false, "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" }, "documents": [] }, { "operationId": "3430ee63-42cb-4f4e-a387-a6de9516109c", "isVisible": true, "status": "PENDING", "type": "TRANSFER", "paymentType": "EMPTY", "createdAt": "2025-10-20T09:53:28Z", "updatedAt": "2025-10-20T09:55:29Z", "source": { "account": { "id": "UjmLCEcZCXzb", "name": "USD", "number": "", "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" } } }, "destination": { "account": { "id": "UavUkRR7OBzh", "name": "USD", "number": "", "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" } } }, "sourceAmount": { "sum": { "currencyCode": "USD", "units": "10", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "10", "nanos": 0 } }, "destinationAmount": { "sum": { "currencyCode": "USD", "units": "10", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "10", "nanos": 0 } }, "commissionAmount": { "sum": { "currencyCode": "USD", "units": "12", "nanos": 99999999 }, "default": { "currencyCode": "USD", "units": "12", "nanos": 99999999 } }, "comment": "Test", "reference": "", "isParent": false, "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" }, "documents": [] }, { "operationId": "a2af0244-c004-4759-952d-f3cd778c00df", "isVisible": false, "status": "PENDING", "type": "COMMISSION", "paymentType": "EMPTY", "createdAt": "2025-10-02T09:04:58Z", "updatedAt": "2025-10-02T09:06:58Z", "source": { "account": { "id": "UjmLCEcZCXzb", "name": "USD", "number": "", "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" } } }, "destination": { "account": { "id": "UcJlzOBpEhCE", "name": "Commission Account USD", "number": "", "customer": { "id": "Dnewcvn-euuI-vG0FZCRDjLXS", "name": "Test Eugen Test Eugen", "type": "CORPORATE" } } }, "sourceAmount": { "sum": { "currencyCode": "USD", "units": "2", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "2", "nanos": 0 } }, "destinationAmount": { "sum": { "currencyCode": "USD", "units": "2", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "2", "nanos": 0 } }, "commissionAmount": { "sum": { "currencyCode": "USD", "units": "0", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "0", "nanos": 0 } }, "comment": "Commission for operation: 9576a85e-a0a6-4dc5-a81e-d1921c6fd271", "reference": "", "isParent": false, "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" }, "documents": [] }, { "operationId": "9576a85e-a0a6-4dc5-a81e-d1921c6fd271", "isVisible": true, "status": "PENDING", "type": "EXCHANGE", "paymentType": "EMPTY", "createdAt": "2025-10-02T09:04:58Z", "updatedAt": "2025-10-02T09:06:58Z", "source": { "account": { "id": "UjmLCEcZCXzb", "name": "USD", "number": "", "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" } } }, "destination": { "account": { "id": "UrpI6jMzHnsP", "name": "USDT ERC20", "number": "", "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" } } }, "sourceAmount": { "sum": { "currencyCode": "USD", "units": "98", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "98", "nanos": 0 } }, "destinationAmount": { "sum": { "currencyCode": "USDT_ERC20", "units": "98", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "98", "nanos": 0 } }, "commissionAmount": { "sum": { "currencyCode": "USD", "units": "2", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "2", "nanos": 0 } }, "comment": "Test", "reference": "", "isParent": false, "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" }, "documents": [] }, { "operationId": "379e65d1-b260-4f8a-b81e-dbeb187927bc", "isVisible": false, "status": "SUCCESS", "type": "COMMISSION", "paymentType": "EMPTY", "createdAt": "2025-10-02T09:03:51Z", "updatedAt": "2025-10-02T09:04:23Z", "source": { "account": { "id": "UjmLCEcZCXzb", "name": "USD", "number": "", "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" } } }, "destination": { "account": { "id": "UcJlzOBpEhCE", "name": "Commission Account USD", "number": "", "customer": { "id": "Dnewcvn-euuI-vG0FZCRDjLXS", "name": "Test Eugen Test Eugen", "type": "CORPORATE" } } }, "sourceAmount": { "sum": { "currencyCode": "USD", "units": "20", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "20", "nanos": 0 } }, "destinationAmount": { "sum": { "currencyCode": "USD", "units": "20", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "20", "nanos": 0 } }, "commissionAmount": { "sum": { "currencyCode": "USD", "units": "0", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "0", "nanos": 0 } }, "comment": "Commission for operation: 7e01efe7-2adc-4dfb-8552-bb1837665209", "reference": "", "isParent": false, "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" }, "documents": [] }, { "operationId": "7e01efe7-2adc-4dfb-8552-bb1837665209", "isVisible": true, "status": "SUCCESS", "type": "DEPOSIT", "paymentType": "EMPTY", "createdAt": "2025-10-02T09:03:51Z", "updatedAt": "2025-10-02T09:04:30Z", "source": null, "destination": { "account": { "id": "UjmLCEcZCXzb", "name": "USD", "number": "", "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" } } }, "sourceAmount": { "sum": { "currencyCode": "USD", "units": "1000", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "1000", "nanos": 0 } }, "destinationAmount": { "sum": { "currencyCode": "USD", "units": "1000", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "1000", "nanos": 0 } }, "commissionAmount": { "sum": { "currencyCode": "USD", "units": "20", "nanos": 0 }, "default": { "currencyCode": "USD", "units": "20", "nanos": 0 } }, "comment": "Test payment for covert client", "reference": "", "isParent": false, "customer": { "id": "D7k3xbc-ERrj-lde9k1t3XuaE", "name": "SIRIUS SOLUTIONS LTD", "type": "CORPORATE" }, "documents": [] } ] } ``` --- # 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/operations/list-client-operations.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.