Confirm the bulk import

POSThttps://api.veriko.mx/v1/beneficiaries/imports/{id}/commit

Audience: public
Auth: API key
Permission: beneficiaries:create

Confirms the import job and triggers the row-by-row persistence into GET /v1/beneficiaries. The operation is asynchronous: the endpoint returns 202 and the job moves to committing while the worker processes rows. Poll GET /v1/beneficiaries/imports/{id} until completed or failed.

Commit rules:

valid and correctable rows are persisted (with alias suffix on collision).
fatal and duplicate_account rows are skipped.
Previously archived accounts with the same number are reactivated instead of duplicated.

The per-plan beneficiary cap is live and checked here just as it is on an individual create. Every plan sets it to "unlimited" today, so plan_cap_exceeded never fires; it can start firing without a line of code changing, as soon as a price sets a maximum.

Parameters
Parameter	In	Type	Required	Description
`id`*	path	`integer`	required	Numeric ID of the import job. e.g. `42`

Request

cURLPython•JavaScript•PHP•

curl -X POST 'https://api.veriko.mx/v1/beneficiaries/imports/{id}/commit' \
  -H 'Authorization: Bearer veriko_••••' \
  -H 'Content-Type: application/json'

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response 202**`CommitBeneficiaryImportResponse` — Commit enqueued to the worker. The job transitions to `committing`.
Field	Type	Description
`data`	`object`	Main response payload. Shape varies by endpoint (object, array, or JSON:API envelope with `type`, `id`, `attributes`).
`type`*	`string`	JSON:API resource type. Always `beneficiary_import`. e.g. `beneficiary_import`
`id`*	`string`	Numeric job ID expressed as a string. e.g. `42`
`attributes`*	`object`	Job attributes returned after commit (transition status).
`status`*	`string`	New status after enqueuing the commit. The only possible value is `committing`. e.g. `committing`
`meta`	`object`	Response metadata including API version, route prefix, unique request identifier, and the server timestamp in UTC.
`version`	`string`	API version that processed the request. e.g. `1.47.0`
`api_version`	`string`	API route prefix version (e.g. `v1`). e.g. `v1`
`request_id`	`string`	Unique request identifier (hex). e.g. `a1b2c3d4e5f6`
`datetime`	`object`	Companion descriptor present in every response's meta block (and in outgoing webhook payloads). Lets clients assert the timezone contract without re-reading the spec. e.g. `{"timezone":"UTC","format":"ISO 8601"}`
`timezone`*	`string`	Always `UTC` — the canonical timezone for every datetime field in the body. e.g. `UTC`
`format`*	`string`	Always `ISO 8601` — explicit `Z` suffix on every datetime. e.g. `ISO 8601`
`links`	`object`	Pagination or related links, present only when the endpoint returns a paginated collection.

**Response status codes**`POST /v1/beneficiaries/imports/{id}/commit`
Status	Class	Description	Body
202	`2xx`	Commit enqueued to the worker. The job transitions to `committing`.	`CommitBeneficiaryImportResponse`
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`
403	`4xx`	Insufficient permissions.	`ErrorResponse`
404	`4xx`	The resource does not exist or is not visible to the client	`Error`
422	`4xx`	Commit pre-condition failed. Possible codes: `job_not_committable` (state != preview_ready), `plan_cap_exceeded` (when the cap is active) or the generic `commit_failed` fallback.	`ErrorResponse`

**Errors from `POST /v1/beneficiaries/imports/{id}/commit`**
Status	Code	Example
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b9`
403	`forbidden`	You do not have permission to access this resource. Envelope meta.request_id `d5e6f7a8b9c0`
422	`job_not_committable`	Commit not allowed. Envelope meta.request_id `a5b6c7d8e9f0`