---
title: "Retrieves bill metadata"
method: GET
path: "/bills/{bill_id}/metadata"
tags: ["Bills"]
---

# Retrieves bill metadata

`GET /bills/{bill_id}/metadata`

## Request

- Base URL: `https://api.rillet.com`
- URL: `https://api.rillet.com/bills/{bill_id}/metadata`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/rillet/apis/rillet-accounting-api/docs/bills/:bill_id/metadata/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns this bill's metadata values keyed by definition key. Keys with no value are
omitted. Existing values held by archived definitions remain readable here.
Definition names, types and status come from list-all-metadata-definitions.

## Path parameters

- `bill_id` string, required

## Response `200`

OK

- MetadataValues
  - `metadata` object, required: Values keyed by definition key. A key with no value on this record is omitted. Use list-all-metadata-definitions for definition names, types and status.

## Other responses

- `default`: Error

## Changes

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

[Operation history](https://skmtc.dev/rillet/apis/rillet-accounting-api/changes/bills/:bill_id/metadata/get.md)

---

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