Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

A staff session token, uk_st_…. Minted by sign-up, sign-in or the two-factor exchange.

Headers

X-Organization-Id
string

The organization the caller is acting on — the org_… code that appears in the panel URL. It identifies; the membership JOIN is what authorizes, so a forged code reads nothing. Absent, the session's default organization answers.

Path Parameters

id
string<uuid>
required

Query Parameters

environment
enum<string>
default:live

Which environment to act in. A view parameter, valid only on the staff surface — a machine credential never chooses its environment, it is resolved from the key.

Available options:
live,
test
outcome
enum<string>

Only the lines with this outcome. Omit for every line.

Available options:
pending,
created,
mapped,
matched,
conflict,
failed
limit
integer
default:50

Page size. Values outside 1–200 fall back to 50.

Required range: 1 <= x <= 200
offset
integer
default:0
Required range: x >= 0

Response

The import and the lines behind it.

import
object

One import of a gateway's catalogue. Progress is derived from its lines on every read rather than accumulated as the worker goes — the tallies are a query, never a counter.

rows
object[]