---
title: "Request the drug stock report for a given month at your facility"
method: GET
path: "/drug_stocks"
tags: ["Drug stock"]
---

# Request the drug stock report for a given month at your facility

`GET /drug_stocks`

## Request

- Base URL: `/api/v4` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v4/drug_stocks`
- Auth: HTTP bearer and API key in header `X-USER-ID` and API key in header `X-FACILITY-ID`

## Query parameters

- `date` unknown

## Headers

- `HTTP_X_USER_ID` unknown
- `HTTP_X_FACILITY_ID` unknown

## Response `200`

Drug stocks are returned

- object
  - `month` string
  - `facility_id` string, uuid
  - `drug_stock_form_url` string: This string should not be empty.
  - `drug_stocks` DrugStock[]: List of drug stocks
    - `protocol_drug_id` string, uuid, required
    - `in_stock` integer, required
    - `received` integer, required

## Changes

- **2022-09-12** (v4) `013fe745d166`: 1 info
  - removed the non-success response with the status `404`
- **2022-03-31** (v4) `cbf37ddd0227`: 1 info
  - endpoint added
- **2020-04-20** (v4) `44261500935e`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/simpledotorg/apis/simple-api/changes/drug_stocks/get.md)

---

[API](https://skmtc.dev/simpledotorg/apis/simple-api.md) - [All operations](https://skmtc.dev/simpledotorg/apis/simple-api/llms.txt) - [OpenAPI document](https://skmtc.dev/simpledotorg/apis/simple-api/revisions/31ffa1d07978?raw)