Total Access Docs
Openapi

Batch operations

Submit up to 100 Public Data API operations in a single HTTP request. Each operation is processed independently and the response contains per-item success/failure results. Rate-limited as a single request against the per-key limit. Supports batch-level idempotency via the `Idempotency-Key` header.

POST
/api/v1/public/data/batch

Submit up to 100 Public Data API operations in a single HTTP request. Each operation is processed independently and the response contains per-item success/failure results.

Rate-limited as a single request against the per-key limit. Supports batch-level idempotency via the Idempotency-Key header.

Authorization

ApiKeyAuth
X-API-Key<token>

API key for the Public Data API and MCP bridge. Keys are prefixed with ta_sk_ (production) or ta_test_ (sandbox).

X-API-Key: ta_sk_xxxxxxxxxxxxxxxxxxxx

In: header

Header Parameters

X-API-Version?string

Date-based minor version negotiation (e.g. 2026-07-01). If omitted, the latest version is used.

Match^\d{4}-\d{2}-\d{2}$
Idempotency-Key?string

UUID v4 or arbitrary string (max 255 chars) to prevent duplicate processing of retried requests. When the same key is sent with the same request body, the original response is returned with an X-Idempotent-Replay: true header. If the same key is sent with a different body, a 409 Conflict is returned.

Lengthlength <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/api/v1/public/data/batch" \  -H "Content-Type: application/json" \  -d '{    "operations": [      {        "id": "users",        "action": "get-active-users",        "params": {          "status": "active"        }      },      {        "id": "jobs",        "action": "list-work-items",        "params": {          "item_type": "job",          "limit": 10        }      }    ]  }'
{  "success": true,  "data": {    "results": [      {        "id": "string",        "success": true,        "status": 0,        "data": null,        "error": "string"      }    ],    "succeeded": 0,    "failed": 0,    "total": 0  },  "meta": {    "api_version": "string"  }}
Empty
Empty
Empty