---
title: "Fetch a branch"
method: GET
path: "/branches/{branch_id}"
tags: ["Store API endpoints"]
---

# Fetch a branch

`GET /branches/{branch_id}`

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

## Path parameters

- `branch_id` integer, required

## Headers

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

## Response `200`

Branch retrieved successfully

- Branch — Branch information
  - `id` string, required — The id of the branch
  - `name` string, required — The name of the branch.
  - `brand_id` string, required — the parent brand id of this branch
  - `state` 'UNMAPPED' | 'MAPPED', required — The state of this branch.
  - `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` — Branch with the specified ID was not found
- `500` — Internal server error

---

[API](https://skmtc.net/careemnow/apis/careem-pos-api.md) · [All operations](https://skmtc.net/careemnow/apis/careem-pos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/careemnow/careem-pos-api/versions/374e3e0dddca/schema)