> ## Documentation Index > Fetch the complete documentation index at: https://conductorone-docs-google-workspace-action-examples.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get Overview > Get an organization-wide spend overview for a requested time window. Returns current budget headroom, trends, forecasts, usage coverage, and denials. ## OpenAPI ````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/spend-insights/overview openapi: 3.1.0 info: description: The C1 API is a HTTP API for managing C1 resources. title: C1 API version: 0.1.0-alpha servers: - description: The C1 API server for the current tenant. url: https://{tenantDomain}.conductor.one variables: tenantDomain: default: example description: The domain of the tenant to use for this request. security: - bearerAuth: [] oauth: [] paths: /api/v1/spend-insights/overview: post: tags: - Spend Insights summary: Get Overview description: |- Get an organization-wide spend overview for a requested time window. Returns current budget headroom, trends, forecasts, usage coverage, and denials. operationId: c1.api.spendinsights.v1.SpendInsightsService.GetOverview requestBody: content: application/json: schema: $ref: '#/components/schemas/c1.api.spendinsights.v1.GetOverviewRequest' responses: '200': content: application/json: schema: $ref: >- #/components/schemas/c1.api.spendinsights.v1.GetOverviewResponse description: >- GetOverviewResponse contains current budget state and spend activity for the requested reporting window. x-codeSamples: - lang: go label: GetOverview source: "package main\n\nimport(\n\t\"context\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/shared\"\n\tconductoronesdkgo \"github.com/conductorone/conductorone-sdk-go\"\n\t\"log\"\n)\n\nfunc main() {\n ctx := context.Background()\n\n s := conductoronesdkgo.New(\n conductoronesdkgo.WithSecurity(shared.Security{\n BearerAuth: \"\",\n Oauth: \"\",\n }),\n )\n\n res, err := s.SpendInsights.GetOverview(ctx, nil)\n if err != nil {\n log.Fatal(err)\n }\n if res.GetOverviewResponse != nil {\n // handle response\n }\n}" components: schemas: c1.api.spendinsights.v1.GetOverviewRequest: description: GetOverviewRequest specifies a reporting window of at most 90 days. properties: endTime: format: date-time type: - string - 'null' startTime: format: date-time type: - string - 'null' title: Get Overview Request type: object x-speakeasy-name-override: GetOverviewRequest c1.api.spendinsights.v1.GetOverviewResponse: description: >- GetOverviewResponse contains current budget state and spend activity for the requested reporting window. properties: accountInitialized: description: >- Whether the current organization budget account has recorded activity. type: boolean availability: description: Data availability for the requested reporting window. enum: - REPORTING_AVAILABILITY_UNSPECIFIED - REPORTING_AVAILABILITY_COMPLETE - REPORTING_AVAILABILITY_PARTIAL_RETENTION - REPORTING_AVAILABILITY_OUTSIDE_RETENTION - REPORTING_AVAILABILITY_NO_ACTIVITY type: string x-speakeasy-unknown-values: allow availableEnd: format: date-time type: - string - 'null' availableStart: format: date-time type: - string - 'null' committedNano: description: Settled plus reserved spend in the current budget period. format: int64 type: string consumedNano: description: Spend settled in the current budget period. format: int64 type: string coverage: oneOf: - $ref: '#/components/schemas/c1.api.spendinsights.v1.AttributionCoverage' - type: 'null' currencyCode: description: Currency used for monetary values. type: string denialEvents: description: Number of budget refusals in the reporting window. format: int64 type: string distinctAppCount: description: Number of distinct applications with settled calls. format: int32 type: integer forecast: oneOf: - $ref: '#/components/schemas/c1.api.spendinsights.v1.RunRateForecast' - type: 'null' hasPriorWindow: description: Whether a complete preceding equal-length window is available. type: boolean hasRemainingNano: description: Whether remaining_nano is available for this budget. type: boolean limitNano: description: Current organization spend limit. format: int64 type: string periodEnd: format: date-time type: - string - 'null' periodStart: format: date-time type: - string - 'null' priorWindowConsumedNano: description: Exact settled spend in the preceding equal-length window. format: int64 type: string rateBasis: description: Recorded price bases used by settled calls. items: $ref: '#/components/schemas/c1.api.spendinsights.v1.RateBasisCount' type: - array - 'null' remainingNano: description: Current spend headroom after settled and reserved spend. format: int64 type: string reportingEnd: format: date-time type: - string - 'null' reportingStart: format: date-time type: - string - 'null' reportingWindowConsumedNano: description: Exact settled spend in the requested reporting window. format: int64 type: string reservedNano: description: Spend reserved by in-progress calls. format: int64 type: string state: description: Whether spend governance is configured for the organization. enum: - OVERVIEW_STATE_UNSPECIFIED - OVERVIEW_STATE_RESOLVED - OVERVIEW_STATE_NO_POLICY - OVERVIEW_STATE_NO_CEILING type: string x-speakeasy-unknown-values: allow tokens: oneOf: - $ref: '#/components/schemas/c1.api.spendinsights.v1.TokenEconomics' - type: 'null' trajectory: description: Daily settled-spend totals for the reporting window. items: $ref: '#/components/schemas/c1.api.spendinsights.v1.TrajectoryPoint' type: - array - 'null' title: Get Overview Response type: object x-speakeasy-name-override: GetOverviewResponse c1.api.spendinsights.v1.AttributionCoverage: description: |- AttributionCoverage explains gaps between settled spend and retained call-level usage. properties: fullyAttributed: description: >- Whether settled budget spend equals settled usage with an identified user. type: boolean ledgerMinusAttributedNano: description: >- 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. format: int64 type: string meterAbsentCalls: description: Calls completed without spend governance. format: int64 type: string missingDepartmentCalls: description: Settled calls without a department snapshot. format: int64 type: string missingSubjectCalls: description: Settled calls without an identified user. format: int64 type: string unknownUsageCalls: description: >- 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. format: int64 type: string unrecognizedKnownUsageNano: description: Known call cost whose settlement could not be recorded. format: int64 type: string zeroOrUnpricedCalls: description: Calls that had no positive configured price. format: int64 type: string title: Attribution Coverage type: object x-speakeasy-name-override: AttributionCoverage c1.api.spendinsights.v1.RunRateForecast: description: |- RunRateForecast describes expected spend through the end of the current budget period. Complete-day averages include zero-spend days. properties: completeDays: description: Number of complete UTC days used for the run-rate calculation. format: int32 type: integer daysUntilForecast: description: >- Number of additional history days required before a forecast is available. format: int32 type: integer expectedForecastEligibleAt: format: date-time type: - string - 'null' historyDays: description: Number of usable daily history points loaded for the forecast. format: int32 type: integer kind: description: Method used to calculate this projection. enum: - RUN_RATE_FORECAST_KIND_UNSPECIFIED - RUN_RATE_FORECAST_KIND_COLLECTING_BASELINE - RUN_RATE_FORECAST_KIND_RUN_RATE - RUN_RATE_FORECAST_KIND_FORECAST type: string x-speakeasy-unknown-values: allow modelName: description: Forecasting model name. Present only when kind is FORECAST. type: string periodToDateNano: description: >- Exact spend settled in the current budget period through the current time. format: int64 type: string points: description: >- Daily forecast points for the remainder of the current budget period. items: $ref: '#/components/schemas/c1.api.spendinsights.v1.ForecastPoint' type: - array - 'null' projectedP20Nano: description: Low projected spend for the full current budget period. format: int64 type: string projectedP50Nano: description: Median projected spend for the full current budget period. format: int64 type: string projectedP80Nano: description: High projected spend for the full current budget period. format: int64 type: string remainingDays: description: Number of complete future UTC days remaining in the budget period. format: int32 type: integer runRateNano: description: >- Mean settled spend per complete UTC day. Valid when complete_days is nonzero. format: int64 type: string title: Run Rate Forecast type: object x-speakeasy-name-override: RunRateForecast c1.api.spendinsights.v1.RateBasisCount: description: >- RateBasisCount summarizes settled calls that used one recorded price basis. properties: calls: description: Number of settled calls that used this price basis. format: int64 type: string settledNano: description: Total settled spend for these calls. format: int64 type: string snapshot: oneOf: - $ref: '#/components/schemas/c1.models.claw.v1.ClawLLMRateSnapshot' - type: 'null' title: Rate Basis Count type: object x-speakeasy-name-override: RateBasisCount c1.api.spendinsights.v1.TokenEconomics: description: TokenEconomics summarizes token usage and cost for settled calls. properties: billableTokens: description: Total billable input, output, cache-read, and cache-write tokens. format: int64 type: string blendedCostPerMillionTokensNano: description: Blended settled cost per million billable tokens. format: int64 type: string cacheReadTokens: description: Input tokens served from cache. format: int64 type: string cacheReadValueNano: description: Savings from cache reads compared with uncached input prices. format: int64 type: string cacheWriteCostNano: description: Cost of writing tokens to cache. format: int64 type: string cacheWriteTokens: description: Tokens written to cache. format: int64 type: string inputTokens: description: Input tokens processed. format: int64 type: string outputTokens: description: Output tokens generated. format: int64 type: string reasoningTokens: description: Reasoning tokens generated. format: int64 type: string settledCalls: description: Number of calls with settled spend. format: int64 type: string title: Token Economics type: object x-speakeasy-name-override: TokenEconomics c1.api.spendinsights.v1.TrajectoryPoint: description: TrajectoryPoint represents settled spend for one UTC day. properties: consumedNano: description: >- Spend settled during the day, in billionths of the configured currency unit. format: int64 type: string day: format: date-time type: - string - 'null' title: Trajectory Point type: object x-speakeasy-name-override: TrajectoryPoint c1.api.spendinsights.v1.ForecastPoint: description: ForecastPoint represents projected spend for one future UTC day. properties: day: format: date-time type: - string - 'null' p20Nano: description: Low spend projection for the day. format: int64 type: string p50Nano: description: Median spend projection for the day. format: int64 type: string p80Nano: description: High spend projection for the day. format: int64 type: string title: Forecast Point type: object x-speakeasy-name-override: ForecastPoint c1.models.claw.v1.ClawLLMRateSnapshot: description: ClawLLMRateSnapshot is the exact price basis selected for one call. properties: asOf: description: The asOf field. type: string cacheReadNanoPerMillionTokens: description: The cacheReadNanoPerMillionTokens field. format: int64 type: string cacheWriteNanoPerMillionTokens: description: The cacheWriteNanoPerMillionTokens field. format: int64 type: string citation: description: The citation field. type: string inputNanoPerMillionTokens: description: The inputNanoPerMillionTokens field. format: int64 type: string note: description: The note field. type: string outputNanoPerMillionTokens: description: The outputNanoPerMillionTokens field. format: int64 type: string source: description: The source field. enum: - 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 type: string x-speakeasy-unknown-values: allow title: Claw Llm Rate Snapshot type: object x-speakeasy-name-override: ClawLLMRateSnapshot securitySchemes: bearerAuth: scheme: bearer type: http oauth: description: >- This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187) function. flows: clientCredentials: scopes: {} tokenUrl: /auth/v1/token type: oauth2 ````