Aller au contenu

API de Radar des remises

Une API REST en lecture seule pour les organisations Partenaire courtier. Analysez des lignes selon les mêmes règles que l’analyse gratuite et consultez les décrets suivis, vos entités et vos importations rapprochées, chaque résultat avec sa référence.

Clés et authentification

Les propriétaires et les administrateurs créent les clés dans l’espace de travail, sous Paramètres → Clés d’API. Une clé n’est affichée qu’une fois; nous ne conservons que son empreinte SHA-256, et elle peut être révoquée en tout temps.

Envoyez la clé dans l’en-tête Authorization comme jeton porteur (Bearer) à chaque requête. Une clé appartient à une seule organisation : elle donne accès à cette organisation et à ses entités, jamais aux données de quelqu’un d’autre.

Résultats, références et règles provisoires

Chaque résultat comporte la référence officielle anglaise et française du décret et de l’article, la version de la règle dont il découle et un indicateur provisoire. Les résultats provisoires proviennent de règles que FSRC étudie encore au regard des décrets officiels.

L’API n’utilise jamais d’IA : une ligne sans numéro tarifaire à 10 chiffres est renvoyée avec une erreur.

De l’information, pas un avis

Chaque réponse, y compris les erreurs, comporte l’avis de non-responsabilité dans la langue demandée (?locale=en, fr ou es). FSRC fournit de la recherche, non une vérification : un courtier en douane agréé ou un avocat en commerce international vérifie chaque résultat avant toute demande. L’API ne fait jamais de transaction avec l’ASFC.

Limites

  • Jusqu’à 100 lignes par requête d’analyse.
  • 60 requêtes par minute et 2 000 par heure pour chaque clé. Au-delà, l’API répond 429 avec un en-tête Retry-After.
  • Jusqu’à 10 clés actives par organisation.

Points d’accès

POST/api/v1/scan
Évalue jusqu’à 100 lignes (numéro tarifaire, description facultative, valeur, utilisation finale, pays d’origine, date d’importation, entité facultative) et renvoie les résultats de chaque ligne. Rien n’est conservé.
GET/api/v1/orders
Les décrets imposant une surtaxe et les décrets de remise que suit Radar des remises, avec leurs références, leur statut, leurs dates d’entrée en vigueur et les liens vers le texte officiel.
GET/api/v1/entities
Votre organisation et ses entités commerciales ou clientes.
GET/api/v1/imports
Vos dernières importations, pour l’organisation et ses entités.
GET/api/v1/imports/{id}/lines
Les lignes rapprochées d’une importation, page par page.

Description OpenAPI 3.1/api/v1/openapi.json

Une requête d’analyse Exemple

Requête :

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"}]}'

Réponse (abrégée) :

{
  "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": "…"
}

Les erreurs sont aussi en JSON :

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

L’accès à l’API fait partie de l’offre Partenaire courtier.

Voir les offres