> ## 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.json get /usage/runs
openapi: 3.0.0
info:
  title: Noonum API
  version: 1.0.0
  contact:
    name: Noonum Support
    email: hello@noonum.com
  description: >
    Create, read, update, and delete your own investment strategies, browse
    public premade strategies, run semantic search, and call supporting utility
    endpoints.
servers:
  - url: https://api.noonum.ai/v1
security:
  - bearerAuth: []
tags:
  - name: UserStrategies
    description: Create, read, update, and delete your own investment strategies.
  - name: PremadeStrategies
    description: Read public premade strategies and find the ones closest to an objective.
  - name: Helper
    description: >-
      Supporting endpoints for company lookup, objective editing, and health
      checks.
  - name: Benchmarks
    description: Read benchmark data.
  - name: Portfolios
    description: Create, read, update, and delete your portfolios.
  - name: Backtest
    description: Backtest a portfolio without saving it.
  - 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.v1.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:
                    type: string
                    description: A human-readable description of the error.
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.