Get request log details

Get one model call’s result, body previews, and body archive references.

GET https://billing.moi.matrixorigin.cn/api/v1/taas/usage-logs/{id}

Before you begin

1. Prepare a personal access token. For creation and management, see Manage personal access tokens.

2. Select a call from List request logs.

Results are scoped to data accessible to the current user.

Request example

Replace $MOI_PERSONAL_ACCESS_TOKEN and $USAGE_LOG_ID with your personal access token and the selected request log’s ID.

curl --get "https://billing.moi.matrixorigin.cn/api/v1/taas/usage-logs/$USAGE_LOG_ID" \
  -H "X-API-Key: $MOI_PERSONAL_ACCESS_TOKEN"

Path parameters

Parameter	Type	Required	Description
id	string	Yes	The selected request log’s ID, from items[].id in the request log list.

Successful response

Returns HTTP 200 with the selected request log’s details and body archive references.

Response example

{
  "id": "usage_example",
  "user_id": "user_example",
  "model_id": "model_example",
  "model_name": "example-chat-model",
  "requested_model": "example-chat-model",
  "called_at": 1788710400,
  "input_tokens": 12,
  "output_tokens": 8,
  "cache_read_tokens": 0,
  "cache_creation_tokens": 0,
  "cost": "0.0001",
  "status": "success",
  "latency_ms": 120,
  "request_body_ref_id": "body_request_example",
  "response_body_ref_id": "body_response_example",
  "request_body_sha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
  "response_body_sha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
  "request_body_bytes": 2,
  "response_body_bytes": 2,
  "created_at": 1788710400,
  "credential": {
    "type": "personal_access_token",
    "id": "credential_example"
  },
  "request_body": "{}",
  "response_body": "{}",
  "body_refs": [
    {
      "id": "body_request_example",
      "usage_log_id": "usage_example",
      "scope": "user_request",
      "preview_body": "{}",
      "full_sha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
      "status": "complete",
      "preview_bytes": 2,
      "full_bytes": 2,
      "created_at": 1788710400,
      "completed_at": 1788710401
    }
  ]
}

Fields

Field	Type	Description
id	string	Usage log ID.
token_key_id	string	TaaS local key ID, for calls using that credential type.
token_key_name	string	TaaS local key name.
user_id	string	Calling user ID.
user_name	string	Calling user name, when available.
model_id	string	Catalog model object ID.
model_name	string	Actual model name.
requested_model	string	Model name submitted in the request.
caller_ip	string	Caller IP.
called_at	integer	Call time, Unix seconds.
input_tokens	integer	Input tokens.
output_tokens	integer	Output tokens.
cache_read_tokens	integer	Cache-read tokens.
cache_creation_tokens	integer	Cache-creation tokens.
cost	string	Call cost as a decimal string.
status	string	Call result status.
error_type	string	Call error category, when present.
error_message	string	Call error description, when present.
latency_ms	integer	Call latency in milliseconds.
request_body_ref_id	string	Archive reference ID for the request body. Returned when populated.
response_body_ref_id	string	Archive reference ID for the response body. Returned when populated.
request_body_sha256	string	SHA-256 of the full request body. Returned when populated.
response_body_sha256	string	SHA-256 of the full response body. Returned when populated.
request_id	string	Request tracing ID. Returned when populated.
key_hash_prefix	string	Key-hash prefix. Returned when populated.
meter_code	string	Billing meter code. Returned when populated.
pricing_mode	string	Call pricing mode. Returned when populated.
enterprise_plan_id	string	Enterprise plan ID. Returned when populated.
enterprise_plan_name	string	Enterprise plan name. Returned when populated.
enterprise_contract_no	string	Enterprise contract number. Returned when populated.
enterprise_plan_model_id	string	Enterprise plan model ID. Returned when populated.
pricing_snapshot	string	Serialized pricing snapshot. Returned when populated.
settlement_method	string	Settlement method. Returned when populated.
billing_report_status	string	Usage reporting status. Returned when populated.
billing_report_group_id	string	Usage reporting group ID. Returned when populated.
billing_event_key	string	Idempotency key for the billing usage event. Returned when populated.
billing_event_id	string	Billing usage-event ID. Returned when populated.
billing_record_id	string	Billing record ID. Returned when populated.
billing_account_id	string	Billing account ID. Returned when populated.
billing_rated_credit	string	Credit amount rated for this call. Returned when populated.
billing_credit_balance	string	Credit balance recorded from the reporting result. Returned when populated.
billing_credit_available	string	Available credit recorded from the reporting result. Returned when populated.
billing_last_error	string	Latest billing usage-reporting error. Returned when populated.
request_body_bytes	integer	Full request body size in bytes.
response_body_bytes	integer	Full response body size in bytes.
billing_reported_at	integer	Billing reporting time, Unix seconds, when present.
billing_report_attempts	integer	Billing reporting attempts.
created_at	integer	Log creation time, Unix seconds.
credential	object	Credential identity for this call, when recorded.
credential.type	string	Credential type: taas_token_key, personal_access_token, or service_account_api_key.
credential.id	string	Credential object ID.
credential.service_account_id	string	Service account ID; returned for service-account credentials.
request_body	string	Request body preview; may be truncated.
response_body	string	Response body preview; may be truncated.
body_refs	array of object	Associated body archive references.
body_refs[].id	string	Body archive reference ID.
body_refs[].usage_log_id	string	Owning usage log ID.
body_refs[].provider_request_log_id	string	Associated upstream request log ID.
body_refs[].user_id	string	Owning user ID.
body_refs[].token_key_id	string	Associated TaaS local key ID.
body_refs[].request_id	string	Request tracing ID.
body_refs[].body_id	string	Body object ID.
body_refs[].scope	string	Request or response stage for the body.
body_refs[].content_type	string	Body media type, when present.
body_refs[].preview_body	string	Body preview.
body_refs[].full_sha256	string	SHA-256 of the complete body.
body_refs[].status	string	Archive status.
body_refs[].error_message	string	Archive error, when present.
body_refs[].legacy	boolean	Legacy archive marker, when present.
body_refs[].preview_bytes	integer	Preview size in bytes.
body_refs[].full_bytes	integer	Full body size in bytes.
body_refs[].created_at	integer	Archive creation time, Unix seconds.
body_refs[].completed_at	integer	Archive completion time, Unix seconds, when complete.

In field paths, [] denotes each array item.

Next steps

Use the log’s id to List upstream request attempts. To retrieve a complete body, use a body reference from the same log to Download a request or response body.

Last updated on Sep 15, 2026