Skip to main content
GET
Get Import Rows
← Imports Retrieve the parsed and validated rows of an import session. Supports pagination, error-only filtering, column sorting, and cascading column filters for building review UIs.

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
string
Column key to sort by. Must match [a-zA-Z0-9_]+.Example: sort_by=weight
string
Sort direction: asc or desc. Only used when sort_by is set.
string
JSON-encoded object mapping column keys to arrays of allowed values. AND across columns, IN within a column.Example: filters={"country":["Spain","France"],"fuel":["diesel"]}Limits: max 20 filter keys, 500 values per key.

Response

string
UUID of the import session
array[object]
Paginated row data
integer
Current page number
integer
Rows per page
integer
Total number of pages
integer
Total row count (respects errors_only and filters)

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.

Patch Rows

Fix validation errors in specific rows

Validate Import

Run validation on mapped rows