---
title: "Get company inference cost"
method: GET
path: "/companies/{company_id}/inference-cost"
tags: ["companies"]
---

# Get company inference cost

`GET /companies/{company_id}/inference-cost`

## Request

- Base URL: `https://api.schematichq.com`
- URL: `https://api.schematichq.com/companies/{company_id}/inference-cost`
- Auth: API key in header `X-Schematic-Api-Key`

## Path parameters

- `company_id` string, required

## Query parameters

- `end_time` string, date-time: End of the window (exclusive). Pass together with start_time; when both are omitted, the company's current billing period is used
- `start_time` string, date-time: Start of the window (inclusive). Pass together with end_time; when both are omitted, the company's current billing period is used

## Response `200`

OK

- object
  - `data` CompanyInferenceCostResponseData, required
    - `by_model` InferenceModelCostResponseData[], required: Cost and event counts per provider and response model, busiest model first, for at most the 500 busiest models; the totals count every model
      - `costs` InferenceCostAmountResponseData[], required: Summed cost of this model's priced events, one entry per currency
        - `cost` string, required: Summed cost as a decimal string in the currency's major unit (dollars, not cents), with up to 8 decimal places
        - `currency` string, required: Lowercase ISO 4217 currency code of the cost
        - `event_count` integer, required: Number of priced events summed into this cost
      - `event_count` integer, required: Number of inference events for this model, priced or not
      - `provider` string, required: The model provider the events reported, such as openai or anthropic
      - `response_model` string, required: The model the provider reported answering the call
      - `unpriced_event_count` integer, required: Number of this model's events with no known cost
    - `company_id` string, required: The company the cost belongs to
    - `costs` InferenceCostAmountResponseData[], required: Summed cost of priced inference events, one entry per currency. Amounts in different currencies are not converted or combined. Empty when no event in the window was priced
      - `cost` string, required: Summed cost as a decimal string in the currency's major unit (dollars, not cents), with up to 8 decimal places
      - `currency` string, required: Lowercase ISO 4217 currency code of the cost
      - `event_count` integer, required: Number of priced events summed into this cost
    - `end_time` string, date-time, required: End of the window (exclusive)
    - `event_count` integer, required: Number of inference events the company sent in the window, priced or not
    - `start_time` string, date-time, required: Start of the window (inclusive)
    - `unpriced_event_count` integer, required: Number of inference events in the window with no known cost: the event carried none and none could be derived from a price for its model. These add nothing to costs, so a non-zero count means the real cost is higher than reported
  - `params` object, required: Input parameters
    - `end_time` string, date-time: End of the window (exclusive). Pass together with start_time; when both are omitted, the company's current billing period is used
    - `start_time` string, date-time: Start of the window (inclusive). Pass together with end_time; when both are omitted, the company's current billing period is used

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Server error

## Changes

> 524 revisions in range; 1 not diffed.

- **2026-10-30** `7ee079bddf01`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/schematichq/apis/schematic-api/changes/companies/:company_id/inference-cost/get.md)

---

[API](https://skmtc.dev/schematichq/apis/schematic-api.md) - [All operations](https://skmtc.dev/schematichq/apis/schematic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/schematichq/apis/schematic-api/revisions/c56b86491fbf?raw)
