Submit a batch of settlement operations (synchronous NDJSON)

Accepts newline-delimited JSON (application/x-ndjson); the NDJSON media type describes the request wire format only, not how operations are persisted. Each line is one operation, validated and created through the same pipeline as POST /v1/operations, grouped under one generated batchId. Processing is synchronous: the request is received in full and its line count validated before any operation is persisted. The line count is capped (a configured limit, default 50000); an over-limit batch is rejected atomically with 413 and no operations are persisted. Within an accepted batch, one bad line is rejected with a per-line error without aborting the batch. Optionally idempotent via the Idempotency-Key header. Errors are RFC 9457 problem+json.

POST /v1/operations/batch

Submit a batch of settlement operations (synchronous NDJSON)

cURL

curl --request POST \
  --url https://slc.sandbox.lerian.net/v1/operations/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-ndjson' \
  --data '"<string>"'

202

{
  "accepted": 123,
  "batchId": "<string>",
  "errors": [
    {
      "code": "<string>",
      "externalId": "<string>",
      "line": 123,
      "message": "<string>",
      "details": {}
    }
  ],
  "errorsTruncated": true,
  "meta": {
    "requestId": "<string>",
    "timestamp": "<string>"
  },
  "rejected": 123
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Headers

Idempotency-Key · string

Idempotency key for safe retries of the whole batch.

Body

application/x-ndjson

Newline-delimited JSON operations (application/x-ndjson); one CreateOperationRequest per line.

The body is of type string.

Response

202

application/json

Batch accepted; per-line accepted/rejected counts and errors with the meta envelope.

accepted · integer<int64> · required

Count of accepted operations.

Example:

48

batchId · string · required

Generated batch id grouping every line of the submission.

Example:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

errors · object[] | null · required

Per-line rejection errors (capped at the first batchErrorCap entries).

Show child attributes

errorsTruncated · boolean · required

True when more rejections occurred than the errors array lists.

Example:

true

meta · object · required

Batch response envelope metadata (requestId + timestamp).

Show child attributes

rejected · integer<int64> · required

Count of rejected lines.

Example:

2