Brand and Manufacturer Endpoints

This document covers the brand and manufacturer endpoints: reading the brands listed on the marketplace, the brand record a manufacturer account maintains for its own brands, and the authorizations under which a seller may list a gated brand. Brand gating for sellers is governed by the Brand Gating Policy (Sellers) (Brand Gating Policy (Sellers)) and the Brand Gating Policy; this document states the endpoint mechanics.

Access through the developer API is issued by the Company and is limited by seller type: manufacturer and supplier accounts receive API access for importing data, under the Developer Agreement and the API Access Tiers. Brand-record write endpoints are available to the manufacturer account that owns the brand. Nothing in this document grants broader access.

Endpoints

Method	Path	Purpose	Access
GET	`/brands`	List brands, paginated	Any API key
GET	`/brands/{id}`	Read one brand, including its listing status by category	Any API key
PATCH	`/brands/{id}`	Update your own brand's profile: name display, description, logo, website	Brand owner
GET	`/brands/{id}/authorizations`	List seller authorizations for your brand	Brand owner
POST	`/brands/{id}/authorizations`	Record a seller authorization, with evidence	Brand owner
PATCH	`/brands/{id}/authorizations/{authorization_id}`	Renew, amend, or end an authorization	Brand owner
GET	`/authorizations`	List the brand authorizations held by your account as a seller	Any API key

All paths are relative to the base URL https://www.aapawz.com/api. Collections paginate as specified in Pagination and Filtering (Pagination & Filtering). Writes accept an Idempotency-Key header (Idempotency Keys).

The brand object

{
  "id": "brand_acme",
  "name": "Acme",
  "description": "Pet food and supplies since 1987.",
  "logo_url": "https://www.aapawz.com/media/brands/acme.png",
  "website": "https://www.acmepet.example/",
  "status": "live",
  "categories": [
    { "category_id": "cat_pet_food", "status": "live" },
    { "category_id": "cat_pet_toys", "status": "not_listed" }
  ],
  "product_count": 132,
  "created_at": "2026-03-18T12:00:00Z",
  "updated_at": "2026-09-30T15:26:47Z"
}

A brand's listing status is per category, not global: a brand may be live for a product in one category and not listed in another. A product may be offered for sale under a brand only where the brand is live for that product's category and, for gated brands, only by a seller holding a current authorization (see below). Brand status values are defined in Data Types and Enums.

When you list products, use the brand name exactly as it appears on the brand record (Catalog Endpoints): the brand value on your products is matched to this record, and a mismatched spelling creates an unmatched listing that will not show the brand's logo or protections.

Maintaining your brand record

As brand owner, PATCH /brands/{id} updates description, logo_url, and website. Send a logo_url pointing at a publicly reachable image file; the marketplace displays it at the sizes its pages require. Name changes are not self-service: a brand name is an identity buyers rely on, so request a name change through support@aapawz.com with the reason.

If a brand's standing changes: for example, supply is interrupted: the Company may return the brand to a not-live status in affected categories. Products that can no longer be offered under the brand are withdrawn from sale in those categories until the brand is live again. Watch for the brand.updated event (Webhook Event Schemas) to react in your own systems.

Seller authorizations

An authorization is the documented permission for a named seller to list a gated brand. It names the seller, the brand, the kind of authorization, the evidence, and its validity period.

{
  "id": "auth_63bd90",
  "brand_id": "brand_acme",
  "seller_id": "acct_7k2m9x",
  "type": "wholesale_authorization",
  "evidence_url": "https://www.aapawz.com/authorizations/auth_63bd90/letter.pdf",
  "status": "current",
  "valid_from": "2026-01-15",
  "valid_until": "2027-01-14",
  "created_at": "2026-01-15T10:31:00Z",
  "updated_at": "2026-01-15T10:31:00Z"
}

Rules

evidence_url must resolve to the actual authorization document: a purchase order, a wholesale agreement, or the manufacturer's authorization letter. A record without evidence is not an authorization, and listings relying on it will be treated as unauthorized.
An authorization past its valid_until is expired and confers no rights, whether or not its status has been updated yet. Check dates, not status alone, in your own systems, and renew before expiry to keep listings live.
status is pending_review, current, expired, revoked, or ended. The Company reviews recorded authorizations and may revoke one that does not hold up; revocation takes effect for new listings immediately and for existing listings as the Brand Gating Policy provides.

As a seller, GET /authorizations lists the authorizations recorded for your account, so your import systems can check coverage before listing a gated brand (Catalog Endpoints) and can hold stock decisions accordingly (Inventory Endpoints).

Errors

Status	Code	Cause
403	`not_brand_owner`	Your account does not own this brand record
404	`not_found`	No brand or authorization with that identifier exists
422	`evidence_required`	An authorization was submitted without a resolvable evidence document
422	`invalid_period`	`valid_until` is not after `valid_from`
422	`validation_failed`	A field is missing or malformed

Error bodies follow Error Codes.

Governance Endpoints

Franchise Endpoints