---
title: "Budget lookback query"
method: POST
path: "/v1/budgets/lookback"
tags: ["Budgets"]
---

# Budget lookback query

`POST /v1/budgets/lookback`

## Request

- Base URL: `https://api.nops.io`
- URL: `https://api.nops.io/v1/budgets/lookback`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nops/apis/nops-public-api/docs/v1/budgets/lookback/post.ts> (a function with typed inputs; its response is checked against the schema)

Query historical spend for budget planning with filters.

## Request body

- object: JSON request body

## Response `200`

Budget lookback query

- object
  - `data` object, required: JSON object

## Other responses

- `401`: Unauthorized — invalid or missing API key
- `403`: Forbidden — insufficient permissions or entitlement

---

[API](https://skmtc.dev/nops/apis/nops-public-api.md) - [All operations](https://skmtc.dev/nops/apis/nops-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nops/apis/nops-public-api/revisions/ac549fa495dd?raw)