List Batches

Returns a paginated list of your Bulk Client Import batches in all statuses. Use it to find an existing batch, check how many batches are still open against the limit of 3, or recover a batch_id you did not store.

Endpoint

GET /v2/compliance/batch

Link

https://partner.sandbox.delos.financial/openapi/v2.html#/operations/BatchService_ListBatches

Request

Headers

Key	Value	Required
Authorization	<JWT>	Yes
Accept	application/json	Yes

Query Parameters

Parameter	Type	Description	Required	Example
page	integer	Page number, starting at 1.	No	1
page_size	integer	Number of batches per page.	No	20

Response (200 OK)

Returns a ListBatchesResponse.

Response Fields

Field	Type	Description	Example
batches	array[object]	Batch objects. See Create Batch → Response Fields.	—
page	integer	Current page.	1
page_size	integer	Page size.	20
total	integer	Total number of batches.	2

Example Response:

{
  "batches": [
    {
      "batch_id": "01a0af8b-831f-7dbe-8eaf-459f81998958",
      "status": "CLOSED",
      "schema_version": "string",
      "types": [
        "individual",
        "company"
      ],
      "individual_kyc_level": "string",
      "company_kyc_level": "string",
      "party_kyc_levels": [
        "string"
      ],
      "counters": {
        "total": 120,
        "draft": 0,
        "valid": 0,
        "invalid": 3,
        "creating": 2,
        "submitted": 85,
        "finished": 24,
        "change_requested": 4,
        "rejected": 1,
        "failed": 1
      },
      "processed": false,
      "done": false,
      "created_at": "2026-09-28T10:15:30Z",
      "committed_at": "2026-09-28T11:02:04Z",
      "error": ""
    }
  ],
  "page": 1,
  "page_size": 20,
  "total": 1
}

---

Examples

Request

curl --request GET \
  --url <https://partner.sandbox.delos.financial/v2/compliance/batch?page=1&page_size=20> \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <JWT>'

---

Error Responses

Errors are returned as {"code", "message", "details"}, where code is a gRPC status code. Use the HTTP status for error handling.

Authorization fail (401):

{ "code": 16, "message": "Unauthorized", "details": [] }

---

Notes

• Open-batch limit: count batches with status OPEN, CLOSED or CHANGE_REQUESTED to see how close you are to the limit of 3.
• Details: the list returns the same Batch object as Get Batch, including counters.