Method GET/distributor-portal/brands

List the brands you are an active contact at, to build a selector. Distributor contact account session.

On this page

You list every brand your account is an ACTIVE distributor contact at (neither pending nor revoked). This is the call that feeds a brand selector: a distribution company often carries several brands at once, and every other portal entry point answers for ONE SELECTED brand (brand_id), never for all of them at once.

The full address is https://api.sealtrust.io/v1/distributor-portal/brands. The same route exists without the /v1 prefix.

#Authorization

Session of a distributor contact account. See GET /distributor-portal/me for the session rules and the 401/403 refusals.

#Rate limit

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

#Example request

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

#Example response

JSON
[
  {
    "brand_id": 42,
    "brand_code": "7K3QXW9M2A",
    "brand_name": "Exemple SAS",
    "retailer_id": 9,
    "retailer_code": "DIST-DE",
    "retailer_name": "Distribution Exemple GmbH",
    "territory_countries": ["DE", "AT"],
    "alerts_opt_in": false
  },
  {
    "brand_id": 57,
    "brand_code": "9PQ2WZ4KXR",
    "brand_name": "Other Brand SAS",
    "retailer_id": 31,
    "retailer_code": "DIST-OM-DE",
    "retailer_name": "Distribution Exemple GmbH (Other Brand)",
    "territory_countries": ["DE"],
    "alerts_opt_in": true
  }
]

#Response fields

FieldTypeDescription
brand_idintegerThe brand's id — pass it as brand_id to every other portal call.
retailer_idintegerYour distributor at that brand.
territory_countriesarray or nullExclusive contractual territory at that brand.
alerts_opt_inbooleanThat brand turned on GET /distributor-portal/out-of-territory for you.

An empty list never happens for an authorized call that succeeds: an account with no active contact at all gets a 403, not an empty list (see below).

#Errors

CodeConditionWhat to do
401Token missing, unreadable or expired.Sign in again.
403No active contact row for this account, at any brand. Message No active distributor access.Ask a brand to invite you.
429Rate limit exceeded.Wait the delay in Retry-After.

#See also

Your answer opens a pre-filled email in your mail app, addressed to contact@sealtrust.io. You read it over before sending it.

Suggest a correctionReport a problem