---
search:
  tags:
    - Ops
    - POST
seo:
  description: >-
    Any signed in user. Files a pending approval for an override the till cannot
    grant.… Reference for the POST /api/v1/approvals endpoint in the PharmaFlow
    API.
sidebar:
  label: Request a manager approval
  badge: POST
title: Request a manager approval
type: openapi-operation
---
Any signed in user. Files a pending approval for an override the till cannot grant. Branch comes from the session unless branch_id names another, and the caller is the requester.

`POST /api/v1/approvals`

**Request body** (`application/json`, required)

- `branch_id` (string)
- `kind` (string)
- `reference_id` (string)
- `reason` (string)

Request body example:

```json
{
  "branch_id": "string",
  "kind": "string",
  "reference_id": "string",
  "reason": "string"
}
```

**Responses**

- `201` — Approval filed as pending
- `401` — Not authenticated

Response example, 201:

```json
{
  "id": "string",
  "branch_id": "string",
  "kind": "string",
  "reference_id": "string",
  "requested_by": "string",
  "approved_by": "string",
  "status": "string",
  "reason": "string",
  "created_at": "string"
}
```