---
title: "GET Budget Report"
method: GET
path: "/reports/budget"
---

# GET Budget Report

`GET /reports/budget`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/reports/budget`
- Auth: API key in query parameter `access_token`

/reports/budget
Permission level: 4

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required
- `location` integer
- `remote_site` integer
- `position` integer

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `dates` object[]
      - `id` integer
      - `year` integer
      - `week` integer
      - `last_day_in_week` boolean
      - `formatted` string
    - `weeks` object
      - `2012` object
        - `48` object
          - `year` integer
          - `week` integer
          - `start` integer
          - `end` integer
        - `49` object
          - `year` integer
          - `week` integer
          - `start` integer
          - `end` integer
    - `locations` object
      - `0` object
        - `id` integer
        - `name` string
        - `budget` unknown[]
          - unknown
        - `date` object
          - `1317` integer
          - `1321` integer
        - `week` object
          - `2012` object
            - `49` object
              - …
            - `50` object
              - …
      - `42267` object
        - `id` string
        - `name` string
        - `budget` unknown[]
          - unknown
        - `date` object
          - `1317` integer
          - `1321` integer
        - `week` object
          - `2012` object
            - `49` object
              - …
            - `50` object
              - …
  - `token` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/reports/budget/get.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
