> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-terraform-v2-owner-resources.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Search My Spend Usage

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



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/spend-insights/my/usage/search
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/my/usage/search:
    post:
      tags:
        - Spend Insights
      summary: Search My Spend Usage
      description: |-
        Search the caller's retained, finalized AI calls. This is not an
         organization report or a provider invoice.
      operationId: c1.api.spendinsights.v1.SpendInsightsService.SearchMySpendUsage
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/c1.api.spendinsights.v1.SearchMySpendUsageRequest
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.spendinsights.v1.SearchMySpendUsageResponse
          description: SearchMySpendUsageResponse contains one page of caller-only usage.
components:
  schemas:
    c1.api.spendinsights.v1.SearchMySpendUsageRequest:
      description: >-
        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.
      properties:
        appId:
          description: >-
            Optional application filter; does not grant access to another user's
            calls.
          type: string
        endTime:
          format: date-time
          type:
            - string
            - 'null'
        pageSize:
          description: Maximum rows per page. Zero uses the server default.
          format: int32
          type: integer
        pageToken:
          description: >-
            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.
          type: string
        startTime:
          format: date-time
          type:
            - string
            - 'null'
      title: Search My Spend Usage Request
      type: object
      x-speakeasy-name-override: SearchMySpendUsageRequest
    c1.api.spendinsights.v1.SearchMySpendUsageResponse:
      description: SearchMySpendUsageResponse contains one page of caller-only usage.
      properties:
        list:
          description: The list field.
          items:
            $ref: '#/components/schemas/c1.api.spendinsights.v1.MySpendUsageRow'
          type:
            - array
            - 'null'
        nextPageToken:
          description: The nextPageToken field.
          type: string
      title: Search My Spend Usage Response
      type: object
      x-speakeasy-name-override: SearchMySpendUsageResponse
    c1.api.spendinsights.v1.MySpendUsageRow:
      description: |-
        MySpendUsageRow exposes only the caller's call-level usage. Operational
         company-funded calls are excluded. Missing amounts and counts are unknown.
      properties:
        appId:
          description: The appId field.
          type: string
        cacheReadTokens:
          description: The cacheReadTokens field.
          format: int64
          type:
            - string
            - 'null'
        cacheWriteTokens:
          description: The cacheWriteTokens field.
          format: int64
          type:
            - string
            - 'null'
        conversationId:
          description: The conversationId field.
          type: string
        costNano:
          description: >-
            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.
          format: int64
          type:
            - string
            - 'null'
        createdAt:
          format: date-time
          type:
            - string
            - 'null'
        currencyCode:
          description: The currencyCode field.
          type: string
        finalizedAt:
          format: date-time
          type:
            - string
            - 'null'
        inputTokens:
          description: Presence-aware billing inputs, not legacy provider token totals.
          format: int64
          type:
            - string
            - 'null'
        modelId:
          description: The modelId field.
          type: string
        outcome:
          description: The outcome field.
          enum:
            - 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
          type: string
          x-speakeasy-unknown-values: allow
        outputTokens:
          description: The outputTokens field.
          format: int64
          type:
            - string
            - 'null'
        reasoningTokens:
          description: The reasoningTokens field.
          format: int64
          type:
            - string
            - 'null'
        usageId:
          description: The usageId field.
          type: string
        usageIncomplete:
          description: True when trustworthy complete billing inputs are unavailable.
          type: boolean
      title: My Spend Usage Row
      type: object
      x-speakeasy-name-override: MySpendUsageRow
  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

````