Validate Import
Validate Import
Validate mapped rows and return paginated row-level results
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. Useerrors_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_1234567890abcdefstring
required
Your organization UUIDExample:
a8315ef3-dd50-43f8-b7ce-d839e68d51faPath 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 errorsBody 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 key403 Forbidden
Cause: The authenticated user is not a member of the organization404 Not Found
Cause: Import session does not exist or does not belong to your organizationRelated Endpoints
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