Skip to main content
POST
Submit Import
← Imports Submit a validated import session for downstream processing. This creates the data file and starts the processing pipeline that will ingest the records into your organization’s data.
Submission is irreversible. Once submitted, the session cannot be modified or re-submitted. Make sure all row corrections are complete before submitting.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa
string
required
Partner identifier for the submitting applicationExample: dcycle

Path Parameters

string
required
UUID of the import session to submitExample: "11111111-1111-1111-1111-111111111111"

Body Parameters

boolean
default:"false"
When true, submit even if some rows have validation errors. Only valid rows will be processed; error rows are skipped.
object
Additional context values collected late in the wizard (e.g. facility_id for wastes). Values are merged into the session before submission.Example: {"facility_id": "a8315ef3-dd50-43f8-b7ce-d839e68d51fa"}

Response

string
Submission result status (e.g. submitted)
string | null
UUID of the created data file
string | null
UUID of the downstream processing job. Use this to track processing progress.
integer
Number of rows submitted for processing

Example

Successful Response

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The authenticated user is not a member of the organization

404 Not Found

Cause: The import session does not exist or belongs to another organization. Both cases return the same response, so a session id from another organization is indistinguishable from one that does not exist.
Cause: The session’s project is no longer one your organization can import into (for example, the organization was unlinked from it). Every step of the session answers this, not only the submit. Create a new session on a project you work in.

400 Bad Request

Cause: Session has validation errors and ignore_errors is false

409 Conflict

Cause: Session has already been submitted
Cause: A submit interrupted after its file was sent for processing is retried after the session’s temporary data expired. The import may have happened: check the status and the processed records before importing the file again.

410 Gone

Cause: The session’s temporary data (its parsed and validated rows) is gone, for example on the retry of a submit interrupted before sending anything, in a session opened before November 10, 2026 (its data was then kept 7 days). It is otherwise kept for as long as the session, its file and its project exist. Nothing was imported: the session ends expired and every later submit of it answers the same. Create a new session from the file.

422 Unprocessable Entity

Cause: Missing required context field for the template

Get Import Status

Check submission and processing progress

Create Session

Start a new import