Retrieve a receipt
Read the exact usage, rates, cost, and serving revision for an inference request.
GET /v1/org/receipts/{request_id}
Authorization
Authorizationheader · string- Bearer $BOARDWALK_API_KEY. Requires requests:read or inference:write.
Request
Request · cURL
curl https://api.boardwalk.cloud/v1/org/receipts/req_example \
-H "Authorization: Bearer $BOARDWALK_API_KEY"Path parameters
request_idpath · stringrequired- Value from the inference response’s x-request-id header.
Response
Example response. IDs, token counts, and rates are illustrative.
200 · application/json
{
"request_id": "req_example",
"model": "support-agent",
"hf_revision": "0123456789abcdef0123456789abcdef01234567",
"config_revision": "cfg_example",
"engine_version": "example",
"verification": null,
"endpoint": "/v1/chat/completions",
"usage": {
"input_tokens": 100,
"output_tokens": 20,
"cache_read_tokens": 0,
"cache_write_tokens": 0
},
"prices": {
"input_micros_per_mtok": "100000",
"output_micros_per_mtok": "300000",
"cache_read_micros_per_mtok": "50000",
"cache_write_micros_per_mtok": "0"
},
"cost_micros": "16",
"ttft_ms": 120,
"latency_ms": 450,
"finish_reason": "stop",
"status_code": 200,
"streamed": false,
"created_at": "2026-09-16T00:00:00.000Z"
}request_idstring- Identifier from the x-request-id response header.
modelstring- Requested model.
hf_revisionstring- Served weight commit.
config_revisionstring- Serving configuration revision, when available.
base_hf_revisionstring- Base commit for a shared-pool deployment, when applicable.
adapter_hf_revisionstring- Adapter commit, when applicable.
adapter_content_hashstring- Adapter content identity, when applicable.
engine_versionstring- Engine version that served the request.
verificationobject | null- Qualification evidence for this serving configuration.
Child fields
checksobject[]- Qualification checks recorded for this configuration.
Child fields
namestring- Check name.
passedboolean- Whether the check passed.
detailstring- Additional check details. Omitted when unavailable.
outputFingerprintsobject[]- Hashes of fixed qualification completions. Omitted when unavailable.
Child fields
promptstring- Qualification prompt identifier.
sha256string- SHA-256 hash of the completion.
fingerprintCardstring | null- GPU model used for output fingerprints, when known. Omitted when unavailable.
fidelityobject- Fidelity evidence when a checkpoint is served through a derived adapter. Omitted when unavailable.
Child fields
tierstring- exact or approximate.
suitestring- Evaluation suite identifier.
suiteVersionnumber- Evaluation suite version.
nnumber- Scored completions per model identity.
passedobject- Pass counts for each model identity.
Child fields
childnumber- Pass count for the original checkpoint.
adapternumber- Pass count for the derived adapter.
basenumber- Pass count for the base model.
rule1object- Comparison of adapter and checkpoint pass rates.
Child fields
passedboolean- Whether the check passed.
diffPointsnumber- Pass-rate difference in percentage points.
standardErrorPointsnumber- Standard error in percentage points.
rule2object- Token-level comparison against the original checkpoint.
Child fields
statusstring- passed, failed, or vacuous.
identicalAdapterChildnumber- Adapter completions identical to the checkpoint.
identicalBaseChildnumber- Base completions identical to the checkpoint.
medianDivergenceCharsnumber | null- Median first differing character position; null when completions match.
withinUlpMinnumber | null- Minimum fraction of tensor values reproduced within one unit of precision.
measuredAtnumber- Measurement timestamp in epoch milliseconds.
endpointstring- Inference endpoint called.
usageobject- Billable token categories.
Child fields
input_tokensinteger- Uncached input tokens.
output_tokensinteger- Output tokens, including reasoning.
cache_read_tokensinteger | null- Cache reads; null means not reported.
cache_write_tokensinteger | null- Cache writes; null means not reported.
pricesobject- Rates applied to this request.
Child fields
input_micros_per_mtokstring- Uncached input rate. Integer micro-dollars per million tokens.
output_micros_per_mtokstring- Output rate. Integer micro-dollars per million tokens.
cache_read_micros_per_mtokstring- Cache-read rate. Integer micro-dollars per million tokens.
cache_write_micros_per_mtokstring- Cache-write rate. Integer micro-dollars per million tokens.
notestring- Explanation of unavailable cache metering, when applicable.
cost_microsstring- Total cost in integer micro-dollars. Divide by 1,000,000 for USD.
ttft_msnumber | null- Time to first token in milliseconds, when measured.
latency_msnumber- Total request latency in milliseconds.
finish_reasonstring | null- Engine finish reason, when available.
status_codeinteger- HTTP outcome recorded for the request.
streamedboolean- Whether streaming was requested.
created_atstring- Request timestamp in ISO 8601 format.
Availability
A receipt is written after a request reaches a worker, including failures and disconnects. Requests refused before reaching a worker have no receipt. A lookup can briefly return 404 before the record is available. GET /v1/receipts/{request_id} is an alias.
Errors
Errors use the shared error format. Save the x-request-id response header for receipts and support.