GETMéthode GET/distributor-portal/out-of-territory

Vous lisez les pays où des unités de votre distributeur ont été scannées hors de votre territoire contractuel, avec un compte d'occurrences et les dates de première et dernière observation.

⛔ Trois choses que cet appel ne rend jamais : le numéro de série de l'unité, la note interne que la marque peut ajouter à une alerte gris marché (GrayMarketAlert.note), et toute mention d'un autre distributeur. Ce que vous lisez ici, ce sont des comptes, des pays et des dates — rien de plus.

⚠️ Votre marque décide si cet appel affiche quoi que ce soit. Jusqu'à ce qu'elle active cette vue pour ses distributeurs, il répond une liste vide — pas une erreur — car l'afficher sans condition renseignerait justement le distributeur qu'une marque suspecte de fuite. Même une fois activée, une alerte que la marque a déjà écartée, ou qu'elle enquête encore, ne vous parvient jamais ici : seule une alerte que la marque lit comme « nouvelle » ou « confirmée » l'est.

#Autorisation

Session d'un compte contact distributeur. Voir GET /distributor-portal/me.

#Plafond d'appels

30 appels par minute, partagé avec le reste du portail distributeur.

#Paramètres de requête

curl -i "https://api.sealtrust.io/v1/distributor-portal/out-of-territory" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.0000000000000000000000000000.0000000000000000000000000000"

{
  "items": [
    {
      "country": "PL",
      "occurrences": 3,
      "first_seen_at": "2026-09-20T14:02:00Z",
      "last_seen_at": "2026-10-04T11:17:00Z"
    }
  ],
  "total_alerts": 1,
  "total_occurrences": 3
}