Platform

Batch — run up to 20 calc sub-requests in one call

Runs up to 20 calculation sub-requests in a single call, in order, returning one result per sub-request. Each sub-request is dispatched through the same authenticated, metered handler as a direct REST call (so it records one usage event and is validated identically), and a sub-failure (bad path, bad body) is isolated — it does not fail the batch, which always returns 200. Sub-request paths must be calc routes (no /v1/batch nesting, no /v1/usage or /v1/signup). Rate limiting is all-or-nothing: the batch reserves one token per sub-request up front and is rejected whole with 429 if the budget can't cover them. The whole batch shares one calc deadline budget. Deterministic — identical batches produce an identical result_id.

post/v1/batch

Request

  • Base URL: https://api.numeratica.com
  • URL: https://api.numeratica.com/v1/batch
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

Response

One result per sub-request, in order (sub-failures are isolated, not fatal)

result_idstring
engine_versionstring
disclaimerstring

Example response

{
  "result_id": "batch_1a2b3c4d5e6f7a8b",
  "engine_version": "batch-1.0.0"
}

Changes

No recorded changes to this operation across all 1 revision of this API.