`POST` `/api/v1/provider/filing-obligations/bulk`

Record existing registrations and activate filing for up to 100 provider client/state accounts in one atomic control-plane request.

Authentication

Provider API key · scopes provider:clients:write and returns:write

Request

idempotency_key and up to 100 items[] with provider client engagement id, state, optional location, filing cadence, registration data, obligation start, and forward/back draft-return controls. Use asynchronous return jobs for high-volume workpaper generation.

Response

Configured and generated-return totals plus ordered per-item client/state results

Persistence

Atomic across the entire batch: every item writes the canonical registration, obligation timeline, and state account profile in its taxpayer tenant, or no item changes. Never registers a customer with a state.

Example request

curl -X POST https://prophit.ai/api/v1/provider/filing-obligations/bulk \
  -H "Authorization: Bearer $PROPHIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json