---
title: "Budget Years"
method: GET
path: "/v1/references/budget_years"
tags: ["References"]
---

# Budget Years

`GET /v1/references/budget_years`

## Request

- Base URL: `https://api.exhibitday.com`
- URL: `https://api.exhibitday.com/v1/references/budget_years`
- Auth: one of:
  - API key in header `api_key`
  - API key in query parameter `api_key`

Returns the years for which your workspace has a yearly budget, as id/value pairs (most recent year first).

Documentation: https://api.exhibitday.com/Help/V1?epf=3#get-v1-references-budget_years

## Headers

- `If-None-Match` string

## Response `200`

OK

- IdValuePair[]
  - `id` string, nullable
  - `value` string, nullable

## Other responses

- `304`: Not Modified: If-None-Match named the current ETag, so there is no body.
- `400`: Bad Request: a missing or invalid parameter, or a change that is not allowed (error_code says which).
- `401`: Unauthorized: the api_key is missing or invalid, or API access is not enabled for the workspace.
- `404`: Not Found: no object with that id in your workspace, or an unknown URL or method.
- `429`: Too Many Requests: the rate limit was exceeded.
- `500`: Unexpected Internal Error.

---

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