List Data Transfer Imports

Endpoint	Method
/api/admin/settings/data-transfer/imports	GET

Returns every data transfer import across entity types and actions in the { data, meta } envelope, newest first. Each row is one import job — the file uploaded, the entity it targets, and how far it has run.

Pagination

Parameter	Description
page	Page number, 1-based. Default 1.
per_page	Items per page. Default 10, max 50.

Filters

Query parameters that narrow the result. Supplying more than one narrows further — they combine with logical AND. They mirror the admin Imports datagrid filters.

Parameter	Match	Example
code	Entity type (exact).	?code=products
type	Synonym for code (kept for spec compatibility).	?type=products
action	Exact — append or delete.	?action=append
state	Exact.	?state=completed
created_at_from	createdAt >= the given ISO date.	?created_at_from=2026-01-01
created_at_to	createdAt <= the given ISO date.	?created_at_to=2026-12-31

Sorting

Parameter	Values
sort	id (default), state, created_at
order	asc, desc (default desc)

Notes

• The heavy errors and summary blobs are left null on listing rows to keep the response light — fetch a single import with the detail endpoint to read them.
• code is the entity being imported (products, customers, tax_rates, …). action is append or delete.
• processedRowsCount advances as the import runs; errorsCount / invalidRowsCount reflect validation outcomes.

See the Imports overview for field meanings and behaviour.