GETMethod GET/distributor-portal/out-of-territory

You read the countries where units of your distributor were scanned outside your contractual territory, with an occurrence count and the dates of the first and last sighting.

⛔ Three things this call never returns: the unit's serial number, the brand-internal note a brand may add to a grey-market alert (GrayMarketAlert.note), and any mention of another distributor. What you read here is counts, countries and dates — nothing more.

⚠️ Your brand decides whether this call shows anything at all. Until it turns this view on for its distributors, it answers an empty list — not an error — because showing it unconditionally would tip off the very distributor a brand suspects of leaking stock. Even once turned on, an alert the brand has already dismissed, or one it is still investigating, never reaches you here: only an alert the brand reads as "new" or "confirmed" does.

#Authorization

Session of a distributor contact account. See GET /distributor-portal/me.

#Rate limit

30 calls a minute, shared with the rest of the distributor portal.

#Query parameters

#Example request

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

#Example response

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

#Response fields

An empty list means no unit of your distributor has been seen outside its territory yet.

#Errors