Skip to main content
POST
Validate Import

Validate Import

Run validation on the import session using the specified column mapping. Returns a summary of valid/error rows plus paginated row-level validation results. Use errors_only=true to focus on rows that need attention.
You can optionally include value_mappings to pre-resolve category values the user remapped by hand (e.g. mapping "Camión""truck" for the vehicle_type column).

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Path Parameters

string
required
UUID of the import sessionExample: "11111111-1111-1111-1111-111111111111"

Query Parameters

integer
default:"1"
Page number (1-indexed)
integer
default:"50"
Rows per page (1–500)
boolean
default:"false"
When true, only return rows with validation errors

Body Parameters

object
required
Column mapping to use for validation: {target_column: source_column | null}Example: {"origin": "origin", "destination": "destination", "weight": "weight_kg"}
object
User-defined value remappings for category columns. Map of {target_column: {raw_value: canonical_value}}.Example: {"vehicle_type": {"Camión": "truck", "Furgoneta": "van"}}

Response

string
UUID of the import session
integer
Total number of data rows
integer
Number of rows that passed validation
integer
Number of rows with at least one validation error
object
Error counts per column key. Example: {"weight": 2, "date": 1}
object
Warnings about the overall data shape (e.g. missing columns)
array[object]
Paginated row-level validation output
integer
Current page number
integer
Rows per page
integer
Total number of pages

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: Import session does not exist or does not belong to your organization

Confirm Mapping

Persist the mapping before validating

Submit Import

Submit the validated session for processing

Get Unique Values

Inspect category values before validation

Import Overview

Full workflow guide