---
title: "List inference calls"
method: POST
path: "/usage/inferences"
tags: ["Usage"]
---

# List inference calls

`POST /usage/inferences`

Paginated, filterable list of inference calls (/infer + /locate) the caller's user was billed for. Filters: date range, endpoint, free-text search. Ordered by call time DESC.

## Request body

- UsageInferencesRequest
  - `end_date` string, date-time, required
  - `endpoint_filter` string[], nullable
  - `limit` integer
  - `model` string
  - `offset` integer
  - `search` string
  - `session_id` string
  - `sort_by` UsageInferenceSortSpec[], nullable
    - `field` string, required
    - `order` string, required
  - `start_date` string, date-time, required

## Response `200`

OK

- UsageInferencesResponse
  - `inferences` UsageInference[], nullable, required
    - `api_key_id` string
    - `cost_microdollars` integer, required
    - `created_at` string, required
    - `endpoint` string, required
    - `inference_id` string, required
    - `latency_ms` integer, required
    - `model` string, required
    - `ocr_engine` string
    - `ocr_pages` integer, required
    - `session_id` string
    - `vlm_model` string
  - `limit` integer, required
  - `offset` integer, required
  - `total` integer, required

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/axilioai/apis/axilio-api-2.md) · [All operations](https://skmtc.dev/axilioai/apis/axilio-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axilioai/axilio-api-2/revisions/d7ecf9466d6d/schema)