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

# List receipts

> List receipts.



## OpenAPI

````yaml /openapi/solverapi.openapi.json get /v1/receipts
openapi: 3.1.0
info:
  description: >-
    Run approved AI models under data, cost, and time limits. A cost limit can
    stop another provider call after recorded spend reaches the limit; it cannot
    reverse a call already in progress. Each finished run returns a receipt
    naming the selected model and provider without including the prompt or model
    output. Use the model catalog for what your organization can run now.
    Provider secrets never appear in API requests or responses. Retry a mutation
    with the same Idempotency-Key and the same request body.
  title: Millwork API
  version: 1.0.0
servers:
  - url: https://api.getmillwork.dev
security: []
tags:
  - description: >-
      Submit work, check its status, cancel it, and read the result. The API
      calls each run an execution.
    name: Runs
  - description: A record of how a run was handled, without prompt or result content.
    name: Receipts
  - description: Models this organization can use now.
    name: Models
  - description: Providers and sign-in methods that can be connected.
    name: Available providers
  - description: Provider accounts connected to this organization.
    name: Provider connections
  - description: >-
      One-time browser steps for connecting a provider without sending its
      secret in an API request.
    name: Secure credential setup
  - description: Exact models and provider routes available through connected accounts.
    name: Provider models
  - description: Create, label, list, and revoke organization API keys.
    name: API keys
  - description: Organization members and invitations.
    name: Members
  - description: Metered usage and quota state.
    name: Usage
  - description: Account, plan and allowance snapshot.
    name: Account
  - description: Checkout, billing portal and billing profile.
    name: Billing
  - description: Webhook endpoints, deliveries and replay.
    name: Webhooks
  - description: Organization-scoped compliance export.
    name: Compliance export
  - description: >-
      Models, agents, and skills Millwork can choose for a run. The API calls
      each one an arm.
    name: Registered options
  - description: >-
      Checks that score output and can stop, retry, or choose another option
      within the request policy.
    name: Output checks
  - description: Routing proposals and their review lifecycle.
    name: Repair proposals
  - description: Aggregate evaluation trend and repair history.
    name: Evaluation
  - description: Publisher and release identity records for supported models.
    name: Model definitions
  - description: >-
      Protected provider-credential references. Secret material never appears in
      this API.
    name: Credential references
  - description: Dashboard browser sign-in, sign-up, session lookup, and sign-out.
    name: Browser access
  - description: Read-only demo session setup.
    name: Demo
  - description: Machine setup and the authenticated organization profile.
    name: Organizations
paths:
  /v1/receipts:
    get:
      tags:
        - Receipts
      summary: List receipts
      description: List receipts.
      operationId: getReceipts
      parameters:
        - in: query
          name: since
          required: false
          schema:
            format: date-time
            type: string
        - in: query
          name: status
          required: false
          schema:
            $ref: '#/components/schemas/LifecycleState'
        - in: query
          name: arm_id
          required: false
          schema:
            type: string
        - in: query
          name: format
          required: false
          schema:
            enum:
              - export
        - in: query
          name: limit
          required: false
          schema:
            maximum: 200
            minimum: 1
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  receipts:
                    items:
                      additionalProperties: false
                      properties:
                        content_policy:
                          enum:
                            - content_free
                          type: string
                        execution_id:
                          type: string
                        mode:
                          enum:
                            - live
                            - echo
                          type: string
                        slices:
                          items:
                            additionalProperties: false
                            properties:
                              acted_on_eval:
                                additionalProperties: false
                                properties:
                                  action:
                                    $ref: '#/components/schemas/OnEvalAction'
                                  outcome:
                                    enum:
                                      - passed_gate
                                      - fell_back
                                      - repair_accepted
                                      - repair_rejected
                                      - proposal_created
                                    type: string
                                  proposal_id:
                                    type: string
                                required:
                                  - action
                                  - outcome
                                type: object
                              capability:
                                type: string
                              cost:
                                additionalProperties: false
                                properties:
                                  input_tokens:
                                    type: integer
                                  latency_ms:
                                    type: integer
                                  output_tokens:
                                    type: integer
                                  usd:
                                    type: number
                                  waiver:
                                    additionalProperties: false
                                    properties:
                                      reason:
                                        enum:
                                          - sandbox_echo_d9
                                        type: string
                                      waived_usd:
                                        type: number
                                    required:
                                      - reason
                                      - waived_usd
                                    type: object
                                required:
                                  - usd
                                  - latency_ms
                                type: object
                              model_provenance:
                                additionalProperties: false
                                properties:
                                  deployment:
                                    additionalProperties: false
                                    properties:
                                      fallback_policy:
                                        enum:
                                          - none
                                          - source_controlled
                                        type: string
                                      location:
                                        type: string
                                      model_deployment_id:
                                        type: string
                                      pricing_basis:
                                        enum:
                                          - source_reported
                                          - estimated
                                        type: string
                                      protocol_profile:
                                        enum:
                                          - openai_responses
                                          - openai_chat
                                          - anthropic_messages
                                          - gemini_generate_content
                                          - bedrock_converse
                                        type: string
                                      route:
                                        type: string
                                    required:
                                      - model_deployment_id
                                      - protocol_profile
                                      - location
                                      - route
                                      - pricing_basis
                                      - fallback_policy
                                    type: object
                                  requested:
                                    additionalProperties: false
                                    properties:
                                      family:
                                        type: string
                                      model_key:
                                        type: string
                                      publisher_id:
                                        type: string
                                      release:
                                        type: string
                                      served_variant_id:
                                        type: string
                                      upstream_ref:
                                        type: string
                                    required:
                                      - model_key
                                      - publisher_id
                                      - family
                                      - release
                                      - served_variant_id
                                      - upstream_ref
                                    type: object
                                  resolved:
                                    anyOf:
                                      - additionalProperties: false
                                        properties:
                                          attestation:
                                            enum:
                                              - source_response
                                              - gateway_response
                                            type: string
                                          source_request_id:
                                            anyOf:
                                              - type: string
                                              - type: 'null'
                                          upstream_ref:
                                            type: string
                                        required:
                                          - upstream_ref
                                          - source_request_id
                                          - attestation
                                        type: object
                                      - type: 'null'
                                  schema_version:
                                    enum:
                                      - model-attempt-provenance/v1
                                    type: string
                                  source:
                                    additionalProperties: false
                                    properties:
                                      access_lane:
                                        enum:
                                          - byok
                                          - millwork_pool
                                        type: string
                                      auth_scheme:
                                        enum:
                                          - api_key
                                          - oauth2
                                          - aws_sts_sigv4
                                        type: string
                                      commercial_owner:
                                        enum:
                                          - customer
                                          - millwork
                                        type: string
                                      connection_id:
                                        type: string
                                      source_id:
                                        type: string
                                      source_kind:
                                        enum:
                                          - publisher_direct
                                          - gateway
                                          - cloud
                                          - fixture
                                        type: string
                                    required:
                                      - source_id
                                      - source_kind
                                      - connection_id
                                      - access_lane
                                      - commercial_owner
                                      - auth_scheme
                                    type: object
                                required:
                                  - schema_version
                                  - requested
                                  - source
                                  - deployment
                                  - resolved
                                type: object
                              route:
                                additionalProperties: false
                                properties:
                                  cost_coefficient:
                                    type: number
                                  eligible:
                                    items:
                                      type: string
                                    type: array
                                  fallback_chain:
                                    items:
                                      type: string
                                    type: array
                                  mode:
                                    enum:
                                      - live
                                      - echo
                                    type: string
                                  ranking:
                                    enum:
                                      - performed
                                      - skipped_platform_proof
                                    type: string
                                  rejected:
                                    items:
                                      additionalProperties: false
                                      properties:
                                        arm:
                                          type: string
                                        reason:
                                          enum:
                                            - data_class_not_granted
                                            - capability_mismatch
                                            - arm_not_ready
                                          type: string
                                      required:
                                        - arm
                                        - reason
                                      type: object
                                    type: array
                                  selected_arm:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                required:
                                  - selected_arm
                                  - eligible
                                  - rejected
                                  - fallback_chain
                                  - cost_coefficient
                                type: object
                              slice_id:
                                type: string
                              verifier:
                                additionalProperties: false
                                properties:
                                  anchor_results:
                                    additionalProperties:
                                      type: boolean
                                    type: object
                                  contract_sha256:
                                    type: string
                                  contract_version:
                                    type: string
                                  hash:
                                    type: string
                                  id:
                                    type: string
                                  identity:
                                    enum:
                                      - platform.echo
                                    type: string
                                  is_correct:
                                    type: boolean
                                  quality_score:
                                    type: number
                                  task_sha256:
                                    type: string
                                  verifier_id:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                required:
                                  - id
                                  - hash
                                  - verifier_id
                                  - is_correct
                                  - quality_score
                                type: object
                            required:
                              - slice_id
                              - capability
                              - route
                              - cost
                            type: object
                          type: array
                        status:
                          $ref: '#/components/schemas/LifecycleState'
                        totals:
                          additionalProperties: false
                          properties:
                            runtime_s:
                              type: number
                            usd:
                              type: number
                          required:
                            - usd
                            - runtime_s
                          type: object
                      required:
                        - execution_id
                        - status
                        - mode
                        - slices
                        - totals
                        - content_policy
                      type: object
                    type: array
                required:
                  - receipts
                type: object
          description: Default Response
        4XX:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: >-
            Request failure in RFC 7807 format. The `type` field identifies the
            reason. Validation errors list affected fields. Rate and quota
            errors include `retry_after_s` and the `Retry-After` header.
        5XX:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: >-
            Server failure in RFC 7807 format. The response does not include
            internal error details.
      security:
        - bearerAuth: []
        - sessionCookie: []
components:
  schemas:
    LifecycleState:
      enum:
        - accepted
        - queued
        - running
        - progress
        - completed
        - failed
        - cancelled
        - expired
    OnEvalAction:
      enum:
        - gate
        - fallback
        - repair_retry
    Problem:
      additionalProperties: false
      properties:
        detail:
          description: Short, safe, occurrence-specific description. Never a stack trace.
          type: string
        errors:
          description: Per-field validation failures (validation_failed only).
          items:
            additionalProperties: false
            properties:
              field:
                type: string
              message:
                type: string
            required:
              - field
              - message
            type: object
          type: array
        instance:
          description: Unique id for this occurrence, safe to quote in support requests.
          format: uuid
          type: string
        retry_after_s:
          description: >-
            Seconds to wait before retrying (rate_limited and quota_exceeded
            only; mirrored as the Retry-After header).
          type: integer
        status:
          description: HTTP status code, duplicated in the body per RFC 7807.
          type: integer
        title:
          description: Human-readable summary of the problem type.
          type: string
        type:
          description: Stable URI that identifies the error type.
          format: uri
          type: string
      required:
        - type
        - title
        - status
        - instance
      type: object
  securitySchemes:
    bearerAuth:
      description: Organization API key for application requests.
      scheme: bearer
      type: http
    sessionCookie:
      description: Dashboard browser session. Do not use this credential in an application.
      in: cookie
      name: solverapi_session
      type: apiKey

````