> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lomadee.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Get all Brands

> List visible catalog brands for partner integrations (no affiliate links or commission)

## Get all Brands

Returns visible catalog brands (network completed, approved, active, and visible). Requires scope `brands:read`.

The payload has no channels, short URLs, affiliate commission, or
affiliate-specific `isFavorite` state. There is no `isFavorite` filter.

### HTTP Request

```http theme={null}
GET https://api.lomadee.com.br/api/partner/brands
```

### Query Parameters

| Parameter                                  | Type      | Description            |
| ------------------------------------------ | --------- | ---------------------- |
| `page`                                     | integer   | Default 1              |
| `limit`                                    | integer   | Default 20, max 20     |
| `search`                                   | string    | Brand name (full-text) |
| `categories`                               | string    | CSV                    |
| `isExclusive` / `isHighlight` / `isPublic` | boolean   | Network traits         |
| `startAt` / `endAt`                        | date-time | Created-at range       |

```bash theme={null}
curl -X GET "https://api.lomadee.com.br/api/partner/brands?page=1&limit=10" \
  -H "x-api-key: your-partner-api-key"
```


## OpenAPI

````yaml GET /api/partner/brands
openapi: 3.1.0
info:
  title: Lomadee Public API
  description: >-
    REST API for affiliate brands, channels, campaigns, orders, products, and
    link shortener. Authenticate with x-api-key. Rate limit: 60 req/60s per key
    and IP.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.lomadee.com.br/
    description: Production — target URL for all integrations
  - url: https://api-beta.lomadee.com.br/
    description: Beta (legacy) — available during transition; will be retired soon
security:
  - x-api-key: []
paths:
  /api/partner/brands:
    get:
      description: >-
        List visible catalog brands for partner integrations (no affiliate links
        or commission)
      parameters:
        - name: search
          in: query
          schema:
            type: string
        - name: page
          in: query
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          schema:
            type: integer
            default: 20
            maximum: 20
        - name: categories
          in: query
          schema:
            type: string
        - name: isExclusive
          in: query
          schema:
            type: boolean
        - name: isHighlight
          in: query
          schema:
            type: boolean
        - name: isPublic
          in: query
          schema:
            type: boolean
        - name: startAt
          in: query
          schema:
            type: string
            format: date-time
        - name: endAt
          in: query
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: Paginated brands
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                  meta:
                    $ref: '#/components/schemas/Meta'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  schemas:
    Meta:
      type: object
      properties:
        total:
          type: integer
        page:
          type: integer
        limit:
          type: integer
        totalPages:
          type: integer
  responses:
    Unauthorized:
      description: API key missing or invalid
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              message:
                type: string
              code:
                type: string
    Forbidden:
      description: Valid key without required scope
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              message:
                type: string
              code:
                type: string
    TooManyRequests:
      description: Rate limit exceeded (60 req/60s per key + IP)
      headers:
        X-RateLimit-Limit:
          description: Max requests per window
          schema:
            type: integer
        X-RateLimit-Remaining:
          description: Remaining requests in window
          schema:
            type: integer
        X-RateLimit-Reset:
          description: Unix timestamp when window resets
          schema:
            type: integer
        Retry-After:
          description: Seconds until retry
          schema:
            type: integer
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              message:
                type: string
              code:
                type: string
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````