List Imports (GraphQL)

Lists every data transfer import, newest first, as a cursor-paginated connection. Each node is one import job — the file uploaded, the entity it targets, and how far it has run.

Operation

Operation	Type	Purpose
adminSettingsDataTransferImports	QueryCollection	List import jobs (cursor pagination)

Arguments

All arguments are optional and combine in a single query — filter, sort and paginate together.

Pagination

Argument	Description
first	Number of records to return.
after	Cursor to fetch the page after (from pageInfo.endCursor).

Filters

Each filter narrows the result; supplying more than one combines with logical AND. They mirror the admin Imports datagrid filters.

Argument	Type	Match	Example
code	String	Entity type (exact).	"products"
type	String	Synonym for code (kept for spec compatibility).	"products"
action	String	Exact — append or delete.	"append"
state	String	Exact.	"validated"
created_at_from	String	created_at >= the given ISO date.	"2026-01-01"
created_at_to	String	created_at <= the given ISO date.	"2026-12-31"

Sorting

Argument	Type	Values
sort	String	id (default), state, created_at
order	String	asc, desc (default desc)

Quirks

• The heavy errors and summary fields are left null on listing rows to keep the response light — fetch a single import with the detail query 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.

All operations require an admin Bearer token — see Authentication.