---
title: "Fetch a brand"
method: GET
path: "/brands/{brand_id}"
tags: ["Store API endpoints"]
---

# Fetch a brand

`GET /brands/{brand_id}`

## Request

- Base URL: `https://apigateway.careemdash.com/pos/api/v1`
- URL: `https://apigateway.careemdash.com/pos/api/v1/brands/{brand_id}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://identity.careem.com/token` scopes: `pos`
- TypeScript: <https://skmtc.dev/careemnow/apis/careem-pos-api/docs/brands/:brand_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Use this endpoint to fetch an existing brand by its ID.

## Path parameters

- `brand_id` string, required

## Headers

- `Authorization` string, required
- `User-Agent` string, required

## Response `200`

Brand retrieved successfully

- Brand: Contains brand information
  - `id` string, required: A unique brand ID string provided by vendor or restaurant. brand.
  - `name` string, required: The name of the brand.
  - `state` 'UNMAPPED' | 'MAPPED', required: The state of this brand.
  - `created_at` string, required: Time RFC3339 format in UTC in which the brand has been updated
  - `updated_at` string, required: Time RFC3339 format in UTC in which the brand has been updated

## Other responses

- `400`: Bad request
- `404`: Brand with the specified ID was not found
- `500`: Internal server error

---

[API](https://skmtc.dev/careemnow/apis/careem-pos-api.md) - [All operations](https://skmtc.dev/careemnow/apis/careem-pos-api/llms.txt) - [OpenAPI document](https://skmtc.dev/careemnow/apis/careem-pos-api/revisions/1bf0e9d19f04?raw)