Collection

Send a batch of tracking requests

POST/api/batch

Processes up to 500 tracking payloads and returns processed and failed counts, individual error details, and a tracking cache token.

Request body

Name	Type	Description
object[]	object[]

Example request

[]

200The operation completed successfully.

200 example

{
  "cache": {},
  "details": [
    {}
  ],
  "errors": 0,
  "processed": 0,
  "size": {}
}

400Bad request.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

400 example

{
  "error": {
    "code": "bad-request",
    "message": "Bad request.",
    "status": 400
  }
}

500Server error.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

500 example

{
  "error": {
    "code": "server-error",
    "message": "Server error.",
    "status": 500
  }
}

cURL

curl -X POST 'https://api.example.com/api/batch' \
  -H 'Content-Type: application/json' \
  -d '[]'