Skip to main content
Retrieve the billing record for a single Model API request. Use this endpoint when you need to reconcile user-facing usage, audit model costs, or inspect the pricing snapshot that was applied when a request was billed.
Use the same DGrid API key that made the original model request. Billing records are scoped to the authenticated key and cannot be queried across keys.

​
Endpoint

GET https://api.dgrid.ai/api/v1/model-router/billing-json?request_id=<DGRID_REQUEST_ID>
AuthenticationAuthorization: Bearer <DGRID_API_KEY>
RequestQuery parameter
Responseapplication/json

​
Query parameters

ParameterTypeRequiredDescription
request_idstringYesThe ID of the completed Model API request whose billing details you want to retrieve.

​
Get the request ID

DGrid returns the request ID in the DGrid-Request-ID response header of the original model call. Store this value if you need to retrieve the request’s billing details later. 
DGrid-Request-ID: req_178027***********6dc9x

​
Request example

curl --location \
  'https://api.dgrid.ai/api/v1/model-router/billing-json?request_id=<DGRID_REQUEST_ID>' \
  --header 'Authorization: Bearer <DGRID_API_KEY>'

​
Response

​
200 OK

The billing record was found and belongs to the authenticated API key. 
{
  "code": 200,
  "message": "ok",
  "data": {
    "request_id": "req_**********86dc9x",
    "billing_json": {
      "model": "anthropic/claude-opus-4.6",
      "input_cost": 0.54909,
      "output_cost": 0.0027500000000000003,
      "cache_create_cost": 0,
      "cache_read_cost": 0,
      "request_cost": 0,
      "total_cost": 0.55184,
      "supplier_id": 1,
      "input_tokens": 109818,
      "output_tokens": 110,
      "cache_create_tokens": 0,
      "cache_read_tokens": 0,
      "pricing_mode": "usage",
      "pricing_snapshot": {
        "pricing_mode": "usage",
        "input_price_per_1m": 5,
        "output_price_per_1m": 25,
        "cache_create_price": 6.25,
        "cache_read_price": 0.5,
        "price_per_request": null,
        "input_tiers": [],
        "output_tiers": [],
        "cache_create_tiers": [],
        "cache_read_tiers": []
      }
    }
  }
}

​
Billing fields

FieldDescription
modelModel ID used by the original request.
input_tokens / output_tokensToken counts charged for prompt and generated output.
cache_create_tokens / cache_read_tokensCache-related token counts when cache pricing applies.
input_cost / output_costUSD cost attributed to input and output token usage.
cache_create_cost / cache_read_costUSD cost attributed to cache creation and cache reads.
request_costFixed per-request USD cost when the pricing mode includes one.
total_costFinal USD cost billed for the request.
pricing_snapshotThe pricing configuration used at billing time. Later price changes do not modify this historical record.

​
Best practices

  • Save DGrid-Request-ID with your own request logs so you can reconcile usage later.
  • Treat pricing_snapshot as an immutable historical record for the request.
  • All cost and price fields are denominated in USD.
  • Numeric values may contain variable decimal precision. Do not rely on fixed-width decimal formatting.