A valid request URL is required to generate request examples{
"import": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": "stripe",
"provider_account_id": "<string>",
"status": "pending",
"total": 123,
"pending": 123,
"created": 123,
"mapped": 123,
"matched": 123,
"conflicts": 123,
"failed": 123,
"created_at": "2023-11-07T05:31:56Z",
"finished_at": "2023-11-07T05:31:56Z"
},
"rows": [
{
"line": 123,
"provider_price_id": "<string>",
"provider_product_id": "<string>",
"product_name": "<string>",
"kind": "<string>",
"currency": "<string>",
"amount_minor": 123,
"interval_unit": "<string>",
"interval_count": 123,
"tax_behavior": "<string>",
"usage": "<string>",
"status": "pending",
"error_code": "<string>",
"error": "<string>",
"plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"price_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conflicting_plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conflicting_price_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}Read a catalogue import and its lines
The report. ?outcome= narrows to one status, which is how the two lists that matter get read — conflict and failed — without paging through the prices that landed cleanly.
Each line carries what the gateway said as well as what became of it, so a refusal names a price you can find at the gateway rather than a row you cannot.
A valid request URL is required to generate request examples{
"import": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": "stripe",
"provider_account_id": "<string>",
"status": "pending",
"total": 123,
"pending": 123,
"created": 123,
"mapped": 123,
"matched": 123,
"conflicts": 123,
"failed": 123,
"created_at": "2023-11-07T05:31:56Z",
"finished_at": "2023-11-07T05:31:56Z"
},
"rows": [
{
"line": 123,
"provider_price_id": "<string>",
"provider_product_id": "<string>",
"product_name": "<string>",
"kind": "<string>",
"currency": "<string>",
"amount_minor": 123,
"interval_unit": "<string>",
"interval_count": 123,
"tax_behavior": "<string>",
"usage": "<string>",
"status": "pending",
"error_code": "<string>",
"error": "<string>",
"plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"price_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conflicting_plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conflicting_price_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}Autorizações
A staff session token, uk_st_…. Minted by sign-up, sign-in or the two-factor exchange. Only a 401 means it is spent; not_a_member (403) is about the organization named in X-Organization-Id and leaves the token good for the others.
Cabeçalhos
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: the answer is not_a_member (403), which does not mean the session is over. Absent, the session's default organization answers, or — if that membership was revoked while the session was open — any other one the caller still holds.
Parâmetros de caminho
Parâmetros de consulta
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.
live, test Only the lines with this outcome. Omit for every line.
pending, created, mapped, matched, conflict, failed Page size. Values outside 1–200 fall back to 50.
1 <= x <= 200x >= 0