---
title: "Search My Spend Usage"
method: POST
path: "/api/v1/spend-insights/my/usage/search"
tags: ["Spend Insights"]
---

# Search My Spend Usage

`POST /api/v1/spend-insights/my/usage/search`

## Request

- Base URL: `https://example.conductor.one`
- URL: `https://example.conductor.one/api/v1/spend-insights/my/usage/search`
- Auth: HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `/auth/v1/token`

Search the caller's retained, finalized AI calls. This is not an
 organization report or a provider invoice.

## Request body

- C1ApiSpendinsightsV1SearchMySpendUsageRequest: SearchMySpendUsageRequest selects a half-open finalization-time interval. The caller's identity is always obtained from the authenticated session. Bounds must have microsecond precision; finer timestamps are rejected.
  - `appId` string: Optional application filter; does not grant access to another user's calls.
  - `endTime` string, date-time, nullable
  - `pageSize` integer: Maximum rows per page. Zero uses the server default.
  - `pageToken` string: Opaque position token from a previous response. Keep history selectors unchanged when continuing; concurrent writes may shift page boundaries. Caller authorization is applied independently on every request.
  - `startTime` string, date-time, nullable

## Response `200`

SearchMySpendUsageResponse contains one page of caller-only usage.

- C1ApiSpendinsightsV1SearchMySpendUsageResponse: SearchMySpendUsageResponse contains one page of caller-only usage.
  - `list` C1ApiSpendinsightsV1MySpendUsageRow[], nullable: The list field.
    - `appId` string: The appId field.
    - `cacheReadTokens` string, int64, nullable: The cacheReadTokens field.
    - `cacheWriteTokens` string, int64, nullable: The cacheWriteTokens field.
    - `conversationId` string: The conversationId field.
    - `costNano` string, int64, nullable: SETTLED is canonical settled fund spend, even when usage is incomplete. For SETTLE_DROPPED this is qualified usage cost, not settled fund spend. Absent when no exact amount is known; a present zero is measured zero.
    - `createdAt` string, date-time, nullable
    - `currencyCode` string: The currencyCode field.
    - `finalizedAt` string, date-time, nullable
    - `inputTokens` string, int64, nullable: Presence-aware billing inputs, not legacy provider token totals.
    - `modelId` string: The modelId field.
    - `outcome` 'MY_SPEND_USAGE_OUTCOME_UNSPECIFIED' | 'MY_SPEND_USAGE_OUTCOME_SETTLED' | 'MY_SPEND_USAGE_OUTCOME_SETTLE_DROPPED' | 'MY_SPEND_USAGE_OUTCOME_NOT_GOVERNED' | 'MY_SPEND_USAGE_OUTCOME_ZERO_PRICED' | 'MY_SPEND_USAGE_OUTCOME_UNPRICED': The outcome field.
    - `outputTokens` string, int64, nullable: The outputTokens field.
    - `reasoningTokens` string, int64, nullable: The reasoningTokens field.
    - `usageId` string: The usageId field.
    - `usageIncomplete` boolean: True when trustworthy complete billing inputs are unavailable.
  - `nextPageToken` string: The nextPageToken field.

## Changes

- **2026-10-06** `918a4e749f56`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/spend-insights/my/usage/search/post.md)

---

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