Submit a batch of requests

Creates a batch of requests and runs them asynchronously. Each element of data has to be compatible with the body expected by the operation. A batch representing the progress and the status of the process is returned as a result. You can retrieve the results using /v3/batches/:id/results once the batch has finished processing.

This endpoints supports up to 24960 requests.

Complete guide: Batches.

Request

This endpoint expects an object.

operation"POST /v3/transactions"RequiredDefaults to POST /v3/transactions

An enumeration.

datalist of objectsRequired

Response

Successful Response

idstring

A unique identifier for the batch.

operation"POST /v3/transactions"Defaults to POST /v3/transactions

An enumeration.

statusenum

Allowed values: processingcompletederror

The status of the batch. Results are not available for a batch with an error status.

created_atdatetimeDefaults to 1970-01-01T00:00:00.000Z

The timestamp of when the batch was created.

updated_atdatetimeDefaults to 1970-01-01T00:00:00.000Z

The timestamp of when the batch was last updated.

progressinteger

The number of transactions processed so far.

totalinteger

The total number of transactions in the batch.

1	curl -X "POST" \
2	"https://api.ntropy.com/v3/batches/" \
3	-H "Accept: application/json" \
4	-H "X-API-KEY: cd1H...Wmhl" \
5	-H "Content-Type: application/json" \
6	-d '[{
7	"id": "xbx8YP14g565Xk",
8	"description": "SQ* STARBUCKS 10 Union Sq",
9	"date": "2024-03-30",
10	"amount": 10.0,
11	"entry_type": "outgoing",
12	"currency": "USD",
13	"account_holder_id": "35b927b6-6fda-40aa-93b8-95b47c2b2cad",
14	"location": {
15	"country": "US"
16	}
17	}]'
18

1	{
2	"id": "203613d2-83c8-4130-8809-d14206eeec20",
3	"operation": "POST /v3/transactions",
4	"status": "processing",
5	"created_at": "2024-01-01T00:00:00Z",
6	"updated_at": "2024-01-01T00:00:30Z",
7	"progress": 0,
8	"total": 4000
9	}