List Batch Items

Returns a paginated list of batch rows with their current status, customer ID and error, optionally filtered by status. Use it to find the rows you need to act on, for example every row in change_requested or failed.

For full review details of a single row, use Get Batch Item.

Endpoint

GET /v2/compliance/batch/{batch_id}/items

Link

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

Request

Path Parameters

Parameter	Type	Description	Required	Example
batch_id	string	Batch ID returned by Create Batch.	Yes	"01a0af8b-831f-7dbe-8eaf-459f81998958"

Query Parameters

Parameter	Type	Description	Required	Example
status	string	Comma-separated row statuses to include.	No	"change_requested,rejected,failed,invalid"
page	integer	Page number, starting at 1.	No	1
page_size	integer	Number of rows per page.	No	100

Headers

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

Response (200 OK)

Returns a ListBatchItemsResponse.

Response Fields

Field	Type	Description	Example
items	array[object]	BatchItem objects.	—
page	integer	Current page.	1
page_size	integer	Page size.	100
total	integer	Total matching rows.	2

BatchItem object

Field	Type	Description	Example
row_key	string	Your row identifier from the manifest.	"client-001"
type	string	What the row onboards: individual or company.	"individual"
client_id	string	ID of the created customer. Empty for invalid rows: they never get one.	"DNkjZcj-hHJA-yhO8yAX3rBRe"
external_customer_id	string	Your customer identifier from the manifest, stable across batches.	"crm-48213"
status	string	Row status: invalid, valid, creating, submitted, finished, rejected, change_requested or failed.	"submitted"
review_status	string	Current status of the compliance review.	"pending"
error	string	Reason for invalid or failed, or the latest temporary error while the row is being retried.	""
updated_at	string (date-time)	Last change of the row.	"2026-09-28T11:05:12Z"

Example Response:

{
  "items": [
    {
      "row_key": "client-001",
      "type": "individual",
      "client_id": "DNkjZcj-hHJA-yhO8yAX3rBRe",
      "external_customer_id": "crm-48213",
      "status": "change_requested",
      "review_status": "string",
      "error": "",
      "updated_at": "2026-09-28T11:05:12Z"
    },
    {
      "row_key": "client-017",
      "type": "individual",
      "client_id": "",
      "external_customer_id": "crm-48301",
      "status": "invalid",
      "review_status": "",
      "error": "fields.email: value does not match format email",
      "updated_at": "2026-09-28T11:02:09Z"
    }
  ],
  "page": 1,
  "page_size": 100,
  "total": 2
}

---

Examples

Request — rows that need attention

curl --request GET \
  --url <https://partner.sandbox.delos.financial/v2/compliance/batch/01a0af8b-831f-7dbe-8eaf-459f81998958/items?status=change_requested,rejected,failed,invalid> \
  --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.

Batch Not Found (404) — the batch does not exist or belongs to another partner:

{ "code": 5, "message": "batch not found", "details": [] }

Authorization fail (401):

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

---

Notes

• Row statuses: invalid and failed carry the reason in error. finished, rejected and failed are final.
• Rows being retried: while a row is in creating and the platform is retrying a temporary error, error shows the latest retry reason.
• Explanations: for a readable summary of every problem in the batch, use Get Batch Status.