---
title: "Set branch status for a specified duration on SuperApp"
method: POST
path: "/branches/{branch_id}/visibility/status/expiries"
tags: ["Store API endpoints"]
---

# Set branch status for a specified duration on SuperApp

`POST /branches/{branch_id}/visibility/status/expiries`

## Request

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

Use this endpoint to set a branch's status for a specified duration on SuperApp.

In the event of a busy kitchen or unforeseen circumstances that cause delays in order fulfillment, this API can be a useful solution.

## Path parameters

- `branch_id` string, required

## Headers

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

## Request body

- StatusExpiriesRequest: Represents a branch visibility status request
  - `status_id` integer, required: Accepted values (2)
  - `till_time` integer, required: Time in minutes until branch must stay in given status.

## Response `201`

Branch status expiry created successfully

- BranchStatusExpiriesResponse: response of successful branch status expiries transaction.
  - `branch_id` string, required: vendor branch id
  - `status_id` integer, required: status id
  - `start_date` string, required: effective start date and time of given status.
  - `end_date` string, required: effective end date and time of given status.
  - `created_at` string, required: effective created at date and time of given status.
  - `updated_at` string, required: effective updated at date and time of given status.

## Other responses

- `400`: Bad request
- `404`: Either the brand or branch doesn't exist, or branch is not mapped
- `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)