> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noonum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List the runs that used your credits

> Returns every run over the last `days` UTC days, newest first. Each run uses one credit, and a failed run is refunded.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /usage/runs
openapi: 3.0.0
info:
  title: Noonum API v2
  version: 2.0.0
  contact:
    name: Noonum Support
    email: hello@noonum.com
  description: >
    Create and manage investment strategies, portfolios, and backtests. The API
    covers the full strategy lifecycle, including creation and editing, the
    archive and revive flow, version submission and run state, result companies,
    evidence, factsheets, exposures, and taxonomy.
servers:
  - url: https://api.noonum.ai/v2
security:
  - bearerAuth: []
tags:
  - name: UserStrategies
    description: Create, read, update, and manage your own investment strategies.
  - name: Helper
    description: >-
      Shared utilities for company lookup and search, objective tooling, and a
      health check.
  - name: Portfolios
    description: Create, read, update, and delete portfolios.
  - name: Backtest
    description: Run a standalone backtest on a portfolio of companies.
  - name: Segments
    description: >-
      Companies' business segments, grouped into segment groups and tagged to
      GICS, NAICS and ICB industries, and the companies most similar to a
      company by the segments they share. You read a company's segment data once
      you subscribe to the company. A subscription lasts 365 days and cannot be
      cancelled or moved to another company; your plan sets how many you can
      hold at once, and `GET /segments/subscriptions` lists them.
  - name: Usage
    description: Read your plan, your remaining credits, and your credit usage.
paths:
  /usage/runs:
    get:
      tags:
        - Usage
      summary: List the runs that used your credits
      description: >-
        Returns every run over the last `days` UTC days, newest first. Each run
        uses one credit, and a failed run is refunded.
      operationId: app.api.v2.usage.list_usage_runs
      parameters:
        - name: days
          in: query
          required: false
          description: Number of UTC days to include, counting today.
          schema:
            type: integer
            minimum: 1
            maximum: 365
            default: 90
      responses:
        '200':
          description: Your runs, newest first.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    occurred_at:
                      type: string
                      format: date-time
                      description: When the run was submitted.
                      example: '2026-09-12T14:05:31+00:00'
                    strategy_id:
                      type: string
                      format: uuid
                      nullable: true
                      description: The strategy the run was for.
                    strategy_name:
                      type: string
                      nullable: true
                      description: >-
                        The strategy's name. Null once the strategy is
                        permanently deleted.
                      example: AI Chips
                    strategy_deleted:
                      type: boolean
                      description: Whether the strategy has been deleted.
                    kind:
                      type: string
                      enum:
                        - live
                        - historical
                      description: Whether the run was live or historical.
                    refunded:
                      type: boolean
                      description: Whether the run failed and its credit was refunded.
                  required:
                    - occurred_at
                    - strategy_id
                    - strategy_name
                    - strategy_deleted
                    - kind
                    - refunded
        '409':
          description: This login's email already belongs to another Noonum account.
          content:
            application/json:
              schema:
                type: object
                description: A standard error response.
                properties:
                  error:
                    description: A human-readable description of the error.
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT or API Key
      description: |
        Enter 'Bearer' followed by a space and then your JWT or API Key.
        Example: `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`
        or `Bearer YOUR_API_KEY_HERE`

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.