List Client Operations

Retrieves a paginated list of client financial operations (transactions) with comprehensive filtering options. Includes detailed information about sources, destinations, amounts, and operation status.

Endpoint

GET/v2/billing/operation

Link

Gateway APIstagep.tst-apidmndelss.com

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 <JWT>	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:

{
  "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

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

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:

   { "error": "Invalid date format for fromCreatedAt" }

2. Unauthorized:

   { "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

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

{
  "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": []
    }
  ]
}