Get Reference Data
get_reference_dataPaid x402 tool. Get governed public reference data and controlled vocabulary values such as country, currency, unit of measure, industry, status, category, or code mappings. Returns codes, labels, definitions, validity dates, mappings, provenance, and version. Price ID: price.reference.v1.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domain": "<domain>"
},
"name": "get_reference_data"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| codes | No | Exact codes wanted. Set membership, never a substring match; omit it to narrow nothing. | |
| limit | No | Page size, applied after query, codes, and validity have narrowed the list. For mitre-cwe the maximum is 125. | |
| query | No | Optional code or label search: a case-insensitive substring match against a value's code OR its label. Omit it to match every value. | |
| cursor | No | Opaque continuation cursor from a prior identical request. Bound to the operation, the normalized request, and the data_version it paged. | |
| domain | Yes | Reference-data domain identifier, as get_master_data_schema names it. | |
| locale | No | Language tag echoed on every served value and in the answer. Labels are served exactly as the snapshot stores them; there is no translation layer. For mitre-cwe, the tag may contain at most 64 ASCII bytes. | en |
| valid_at | No | The instant to evaluate each value's validity interval at. Defaults to the request clock. A value whose source DECLARES its interval is active when valid_from <= valid_at < valid_to, an absent or null bound open on its side. A value whose source states no interval at all is neither: it is served active: null and carries the reference_value_validity_unknown warning. | |
| include_inactive | No | Whether values declared inactive at valid_at are served. A value whose source states no validity interval is always served, flagged active: null beside the reference_value_validity_unknown warning. False excludes values declared inactive; true serves them flagged active: false beside the reference_value_inactive warning, so an intentionally excluded value is distinguishable from an accidental match. |