Skip to content

Remission Radar API

A read-only REST API for Broker Partner organisations. Scan lines with the same rules as the free scan, and read tracked orders, your entities and reconciled imports, each finding with its citation.

Keys and authentication

Owners and admins create keys in the workspace, under Settings → API keys. A key is shown once; we store only its SHA-256 fingerprint, and it can be revoked at any time.

Send the key in the Authorization header as a bearer token on every request. A key belongs to one organisation: it reaches that organisation and its entities, never anyone else’s data.

Findings, citations and provisional rules

Every finding carries the official English and French citation of the order and section, the rule version it comes from and a provisional flag. Provisional findings come from rules FSRC is still researching against the official orders.

The API never uses AI: a line without a 10-digit tariff item is returned with an error.

Information, not advice

Every response, errors included, carries the disclaimer in the language you ask for (?locale=en, fr or es). FSRC provides research, not verification: a licensed customs broker or trade lawyer verifies each finding before anything is filed. The API never transacts with the CBSA.

Limits

  • Up to 100 lines per scan request.
  • 60 requests a minute and 2,000 an hour per key. Over the limit, the API answers 429 with a Retry-After header.
  • Up to 10 active keys per organisation.

Endpoints

POST/api/v1/scan
Evaluates up to 100 lines (tariff item, optional description, value, end use, country of origin, import date, optional entity) and returns each line’s findings. Nothing is stored.
GET/api/v1/orders
The surtax and remission orders Remission Radar tracks, with citations, status, in-force dates and links to the official text.
GET/api/v1/entities
Your organisation and its business or client entities.
GET/api/v1/imports
Your latest imports, for the organisation and its entities.
GET/api/v1/imports/{id}/lines
The reconciled lines of one import, page by page.

OpenAPI 3.1 description/api/v1/openapi.json

A scan request Example

Request:

curl -X POST https://remissionradar.ca/api/v1/scan?locale=en \
  -H "Authorization: Bearer $REMISSION_RADAR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lines":[{"tariffItem":"7208.51.00.10","value":250000,"endUse":"manufacturing","origin":"US","importDate":"2026-03-15"}]}'

Response (shortened):

{
  "lines": [
    {
      "line": 1,
      "tariffItem": "7208510010",
      "entityId": "…",
      "errors": [],
      "status": "has_findings",
      "surtax": { "instrumentId": "…", "order": "…", "ratePct": 25 },
      "findings": [
        {
          "outcome": "likely",
          "provisional": true,
          "ruleVersionId": "…",
          "instrumentId": "…",
          "citation": { "en": "SOR/…, s. …", "fr": "DORS/…, art. …" },
          "specialAuthorityCode": "…",
          "estimatedAmountCad": 62500,
          "claimDeadline": "2028-03-15",
          "reasons": [],
          "evidence": ["…"]
        }
      ]
    }
  ],
  "disclaimer": "…",
  "rulesDate": "…"
}

Errors are JSON too:

{
  "error": { "code": "rateLimited", "message": "…" },
  "disclaimer": "…",
  "rulesDate": "…"
}

API access is part of Broker Partner.

See plans