Skip to main content
POST
Import Raw Matches
Upload one UTF-8 raw CSV with country_code and currency, using your Public API bearer key and a UUID Idempotency-Key.
Country and currency are required two-letter and three-letter codes, normalized to uppercase. The header must fit within 64 KiB and omit item_id, external_match_id, match_relation, match_method, and match_confidence. Use the existing raw competitor CSV format. Already matched files belong on matched-snapshots. The entire multipart request is limited to 25 MiB, including overhead. Coverage/removal fields do not apply to raw imports. A successful request returns 202 and job_id. Poll GET /v1/matching/jobs/{job_id}/progress. By default (match_catalog=true), this synchronizes the catalog and runs automatic matching. To store data for later matching, add -F "match_catalog=false" to the request. Load-only imports do not synchronize or require a catalog and do not launch matching. Every valid raw row remains in Price Radar, even without a catalog match. Results include counts and at most 200 rejection samples. Existing raw CSV validation still applies: an import with more than 2% invalid rows fails rather than committing a partial dataset. For load-only imports, result_summary.stored counts stored valid rows, accepted equals stored, rejected counts invalid input rows only, and sent equals stored + rejected. row_errors contains invalid-row diagnostics; unmatched rows are not rejections. With matching enabled, existing accepted/rejected semantics remain unchanged and stored is omitted. Loading raw rows does not create matches or refresh grid prices; match the stored data later to publish those effects. One organization-wide matching upload runs at a time; a different concurrent upload returns 409. An identical retry returns the same job without another matching run. Reusing a key with different file bytes, market options, or match_catalog returns 409. Receipt bindings are retained indefinitely. Abandoned admissions without a job expire after 24 hours, their files are removed by maintenance, and the same key returns 410; use a new key. Terminal job file cleanup follows the existing worker lifecycle. Authentication failures return 401, oversize requests 413, and invalid headers/market fields 422. Check the job’s terminal status even after 202.

Headers

Idempotency-Key
string<uuid>
required

Body

multipart/form-data
file
file
required
country_code
string
required
currency
string
required

Response

Successful Response

Minimal handle returned by async enqueue endpoints.

The full job status is fetched separately via GET /v1/jobs/{id}.

job_id
string<uuid>
required