> ## Documentation Index
> Fetch the complete documentation index at: https://giftbit.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve brand

> Retrieves extended information about the specified brand.



## OpenAPI

````yaml /api-reference/openapi.yaml get /brands/{brand_code}
openapi: 3.1.0
info:
  title: Giftbit API
  version: v1
  description: >
    Giftbit's REST API lets you automatically order rewards and send them to
    your

    recipients. Delivery can be handled either by links that integrate into
    another

    system's workflow, or by emails sent through the Giftbit system.


    Authenticate every request with a bearer token in the `Authorization`
    header.

    Only an HTTP `200` means success; all non-`200` responses share a common
    error body.
  contact:
    name: Giftbit Support
    email: testbed@giftbit.com
    url: https://www.giftbit.com/api-documentation
servers:
  - url: https://api-testbed.giftbit.com/papi/v1
    description: Testbed
  - url: https://api.giftbit.com/papi/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Ping
    description: Test your authentication and check the health of the Giftbit API.
  - name: Brands
    description: List reward brands and retrieve extended information about a single brand.
  - name: Regions
    description: List the regions used to filter brands and request Full Catalog rewards.
  - name: Email Orders
    description: Order one or more rewards delivered to recipients by Giftbit email.
  - name: Shortlink Orders
    description: Order branded shortlink rewards that include a customized landing page.
  - name: Direct Link Orders
    description: >-
      Order minimally branded direct link rewards returned immediately in the
      response.
  - name: Embedded Rewards
    description: >-
      Order a single in-app reward for immediate delivery in your app or
      website.
  - name: Funds
    description: Retrieve your account balance and top it up with a credit card payment.
  - name: Rewards
    description: List, retrieve, resend, and cancel individual rewards.
paths:
  /brands/{brand_code}:
    get:
      tags:
        - Brands
      summary: Retrieve brand
      description: Retrieves extended information about the specified brand.
      operationId: retrieve-brand
      parameters:
        - name: brand_code
          in: path
          required: true
          description: Retrieve a single brand by `brand_code`.
          schema:
            type: string
      responses:
        '200':
          description: The brand has been retrieved.
          content:
            application/json:
              schema:
                type: object
                properties:
                  brand:
                    $ref: '#/components/schemas/BrandDetail'
                  info:
                    $ref: '#/components/schemas/Info'
              example:
                brand:
                  brand_code: WHOLEFOODS
                  name: Whole Foods Market
                  image_url: >-
                    https://uploadedimages.giftbit.com/wholefoods/wholefoodsgiftbit-f629cfa4-c7f1-4c6f-9a67-f8ee144b8db7.png
                  regions:
                    - 2
                  fund_currencyisocode: USD
                  inapp_available: true
                  variable_price: false
                  allowed_prices_in_cents:
                    - 1000
                    - 2500
                    - 5000
                    - 10000
                info:
                  code: INFO_BRANDS_RETRIEVED
                  name: Brand(s) Retrieved
                  message: A list of brands or single brand has been retrieved
        '422':
          description: No brand found matching that code.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: ERROR_BRANDS_NO_SUCH_BRAND
                  name: No brand found
                  message: No brand found matching that code
                status: 422
components:
  schemas:
    BrandDetail:
      allOf:
        - $ref: '#/components/schemas/Brand'
        - type: object
          properties:
            regions:
              type: array
              items:
                type: integer
              description: Region ids (per `/regions`) in which this brand is available.
            fund_currencyisocode:
              type: string
            inapp_available:
              type: boolean
            variable_price:
              type: boolean
              description: >-
                True if rewards can be any value within a range; false if only
                fixed prices are allowed.
            min_price_in_cents:
              type: integer
              description: Present only if variable_price is true.
            max_price_in_cents:
              type: integer
              description: Present only if variable_price is true.
            allowed_prices_in_cents:
              type: array
              items:
                type: integer
              description: Present only if variable_price is false.
    Info:
      type: object
      description: Status information returned on successful requests.
      properties:
        code:
          type: string
          description: An enum-style status code for the request.
        name:
          type: string
          description: Human-readable status name.
        message:
          type: string
          description: Request-context-specific message.
    ErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/Error'
        status:
          type: integer
          description: An integer that matches the HTTP status code returned.
    Brand:
      type: object
      properties:
        brand_code:
          type: string
          description: A unique alphanumeric identifier for the brand.
        name:
          type: string
        disclaimer:
          type: string
          description: >-
            Disclaimer text that must appear along with the brand when
            displayed. Omitted if none.
        image_url:
          type: string
          description: A full, secure (https) URL to the brand's image.
    Error:
      type: object
      properties:
        code:
          type: string
          description: An enum-style error code that will not change.
        name:
          type: string
          description: Human-readable error name.
        message:
          type: string
          description: Request-specific information about the error.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Send your API token prefixed by `Bearer ` in the `Authorization` header.

````