--- title: "Get Overview" method: POST path: "/api/v1/spend-insights/overview" tags: ["Spend Insights"] --- # Get Overview `POST /api/v1/spend-insights/overview` ## Request - Base URL: `https://example.conductor.one` - URL: `https://example.conductor.one/api/v1/spend-insights/overview` - Auth: HTTP bearer and OAuth 2 - Client credentials - Token URL: `/auth/v1/token` Get an organization-wide spend overview for a requested time window. Returns current budget headroom, trends, forecasts, usage coverage, and denials. ## Request body - C1ApiSpendinsightsV1GetOverviewRequest: GetOverviewRequest specifies a reporting window of at most 90 days. - `endTime` string, date-time, nullable - `startTime` string, date-time, nullable ## Response `200` GetOverviewResponse contains current budget state and spend activity for the requested reporting window. - C1ApiSpendinsightsV1GetOverviewResponse: GetOverviewResponse contains current budget state and spend activity for the requested reporting window. - `accountInitialized` boolean: Whether the current organization budget account has recorded activity. - `availability` 'REPORTING_AVAILABILITY_UNSPECIFIED' | 'REPORTING_AVAILABILITY_COMPLETE' | 'REPORTING_AVAILABILITY_PARTIAL_RETENTION' | 'REPORTING_AVAILABILITY_OUTSIDE_RETENTION' | 'REPORTING_AVAILABILITY_NO_ACTIVITY': Data availability for the requested reporting window. - `availableEnd` string, date-time, nullable - `availableStart` string, date-time, nullable - `committedNano` string, int64: Settled plus reserved spend in the current budget period. - `consumedNano` string, int64: Spend settled in the current budget period. - `coverage` C1ApiSpendinsightsV1AttributionCoverage: AttributionCoverage explains gaps between settled spend and retained call-level usage. - `fullyAttributed` boolean: Whether settled budget spend equals settled usage with an identified user. - `ledgerMinusAttributedNano` string, int64: Settled budget spend minus settled usage with an identified user. Signed. Under PARTIAL_RETENTION or OUTSIDE_RETENTION, this difference includes aged-out usage records and is not a measure of unattributed spend alone. - `meterAbsentCalls` string, int64: Calls completed without spend governance. - `missingDepartmentCalls` string, int64: Settled calls without a department snapshot. - `missingSubjectCalls` string, int64: Settled calls without an identified user. - `unknownUsageCalls` string, int64: Newly observed or classified calls in this retained finalized window whose usage or price is unqualified. Historical rows without observations keep their legacy treatment; they do not become observed complete calls. - `unrecognizedKnownUsageNano` string, int64: Known call cost whose settlement could not be recorded. - `zeroOrUnpricedCalls` string, int64: Calls that had no positive configured price. - `currencyCode` string: Currency used for monetary values. - `denialEvents` string, int64: Number of budget refusals in the reporting window. - `distinctAppCount` integer: Number of distinct applications with settled calls. - `forecast` C1ApiSpendinsightsV1RunRateForecast: RunRateForecast describes expected spend through the end of the current budget period. Complete-day averages include zero-spend days. - `completeDays` integer: Number of complete UTC days used for the run-rate calculation. - `daysUntilForecast` integer: Number of additional history days required before a forecast is available. - `expectedForecastEligibleAt` string, date-time, nullable - `historyDays` integer: Number of usable daily history points loaded for the forecast. - `kind` 'RUN_RATE_FORECAST_KIND_UNSPECIFIED' | 'RUN_RATE_FORECAST_KIND_COLLECTING_BASELINE' | 'RUN_RATE_FORECAST_KIND_RUN_RATE' | 'RUN_RATE_FORECAST_KIND_FORECAST': Method used to calculate this projection. - `modelName` string: Forecasting model name. Present only when kind is FORECAST. - `periodToDateNano` string, int64: Exact spend settled in the current budget period through the current time. - `points` C1ApiSpendinsightsV1ForecastPoint[], nullable: Daily forecast points for the remainder of the current budget period. - `day` string, date-time, nullable - `p20Nano` string, int64: Low spend projection for the day. - `p50Nano` string, int64: Median spend projection for the day. - `p80Nano` string, int64: High spend projection for the day. - `projectedP20Nano` string, int64: Low projected spend for the full current budget period. - `projectedP50Nano` string, int64: Median projected spend for the full current budget period. - `projectedP80Nano` string, int64: High projected spend for the full current budget period. - `remainingDays` integer: Number of complete future UTC days remaining in the budget period. - `runRateNano` string, int64: Mean settled spend per complete UTC day. Valid when complete_days is nonzero. - `hasPriorWindow` boolean: Whether a complete preceding equal-length window is available. - `hasRemainingNano` boolean: Whether remaining_nano is available for this budget. - `limitNano` string, int64: Current organization spend limit. - `periodEnd` string, date-time, nullable - `periodStart` string, date-time, nullable - `priorWindowConsumedNano` string, int64: Exact settled spend in the preceding equal-length window. - `rateBasis` C1ApiSpendinsightsV1RateBasisCount[], nullable: Recorded price bases used by settled calls. - `calls` string, int64: Number of settled calls that used this price basis. - `settledNano` string, int64: Total settled spend for these calls. - `snapshot` C1ApiSpendinsightsV1ClawLLMRateSnapshot: ClawLLMRateSnapshot records the exact price basis selected for a call. - `asOf` string: Date the price basis took effect. - `cacheReadNanoPerMillionTokens` string, int64: Cache-read token price, in nano-units per million tokens. - `cacheWriteNanoPerMillionTokens` string, int64: Cache-write token price, in nano-units per million tokens. - `citation` string: Reference for the price basis. - `inputNanoPerMillionTokens` string, int64: Input token price, in nano-units per million tokens. - `note` string: Operator note recorded with the price basis. - `outputNanoPerMillionTokens` string, int64: Output token price, in nano-units per million tokens. - `source` 'CLAW_LLM_RATE_SOURCE_UNSPECIFIED' | 'CLAW_LLM_RATE_SOURCE_LIST_PRICE' | 'CLAW_LLM_RATE_SOURCE_NEGOTIATED' | 'CLAW_LLM_RATE_SOURCE_OPERATOR_OVERRIDE' | 'CLAW_LLM_RATE_SOURCE_CUSTOMER_SUPPLIED': Provenance of the recorded prices. - `remainingNano` string, int64: Current spend headroom after settled and reserved spend. - `reportingEnd` string, date-time, nullable - `reportingStart` string, date-time, nullable - `reportingWindowConsumedNano` string, int64: Exact settled spend in the requested reporting window. - `reservedNano` string, int64: Spend reserved by in-progress calls. - `state` 'OVERVIEW_STATE_UNSPECIFIED' | 'OVERVIEW_STATE_RESOLVED' | 'OVERVIEW_STATE_NO_POLICY' | 'OVERVIEW_STATE_NO_CEILING': Whether spend governance is configured for the organization. - `tokens` C1ApiSpendinsightsV1TokenEconomics: TokenEconomics summarizes token usage and cost for settled calls. - `billableTokens` string, int64: Total billable input, output, cache-read, and cache-write tokens. - `blendedCostPerMillionTokensNano` string, int64: Blended settled cost per million billable tokens. - `cacheReadTokens` string, int64: Input tokens served from cache. - `cacheReadValueNano` string, int64: Savings from cache reads compared with uncached input prices. - `cacheWriteCostNano` string, int64: Cost of writing tokens to cache. - `cacheWriteTokens` string, int64: Tokens written to cache. - `inputTokens` string, int64: Input tokens processed. - `outputTokens` string, int64: Output tokens generated. - `reasoningTokens` string, int64: Reasoning tokens generated. - `settledCalls` string, int64: Number of calls with settled spend. - `trajectory` C1ApiSpendinsightsV1TrajectoryPoint[], nullable: Daily settled-spend totals for the reporting window. - `consumedNano` string, int64: Spend settled during the day, in billionths of the configured currency unit. - `day` string, date-time, nullable ## Changes - **2026-10-20** `fe943bedf41b`: 1 breaking, 1 info - added `#/components/schemas/c1.api.spendinsights.v1.ClawLLMRateSnapshot` to the `rateBasis/items/snapshot` response property `oneOf` list for the response status `200` - removed `#/components/schemas/c1.models.claw.v1.ClawLLMRateSnapshot` from the `rateBasis/items/snapshot` response property `oneOf` list for the response status `200` - **2026-10-06** `918a4e749f56`: 1 info - endpoint added [Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/spend-insights/overview/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)