---
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`

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.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/revisions/374e3e0dddca/schema)
