---
title: "Retrieves customer metadata"
method: GET
path: "/customers/{customer_id}/metadata"
tags: ["Customers"]
---

# Retrieves customer metadata

`GET /customers/{customer_id}/metadata`

## Request

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

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

## Path parameters

- `customer_id` string, uuid, 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/customers/:customer_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)