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

# List projects

> List all projects for your organization with search and sorting capabilities.

    Projects help organize related programs and proofs. You can search by name and sort by various criteria.



## OpenAPI

````yaml GET /v1/projects
openapi: 3.1.0
info:
  title: Axiom Proving API
  description: |-
    ## Axiom Cloud Proving API

        The Axiom Proving API allows you to compile, execute, and prove OpenVM programs on Axiom's cloud infrastructure.

        All endpoints require an API key passed in the `Axiom-API-Key` header.
        
  version: 1.0.0
servers:
  - url: https://api.axiom.xyz
    description: Production API
  - url: https://api.staging.app.axiom.xyz
    description: Staging API
security: []
paths:
  /v1/projects:
    get:
      tags:
        - projects
      summary: List Projects
      description: >-
        List all projects for your organization with search and sorting
        capabilities.

            Projects help organize related programs and proofs. You can search by name and sort by various criteria.
      operationId: list_projects_v1_projects_get
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
            title: Page
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 20
            title: Page Size
        - name: search
          in: query
          required: false
          schema:
            type: string
            description: Search projects by name or ID
            default: ''
            title: Search
          description: Search projects by name or ID
        - name: sort_by
          in: query
          required: false
          schema:
            type: string
            description: >-
              Sort by: created_at, name, last_active_at, program_count,
              total_proofs_run
            default: created_at
            title: Sort By
          description: >-
            Sort by: created_at, name, last_active_at, program_count,
            total_proofs_run
        - name: sort_direction
          in: query
          required: false
          schema:
            type: string
            description: 'Sort direction: asc or desc'
            default: desc
            title: Sort Direction
          description: 'Sort direction: asc or desc'
      responses:
        '200':
          description: Projects retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginationResponse_FeProjectResponse_'
        '404':
          description: Not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    PaginationResponse_FeProjectResponse_:
      properties:
        items:
          items:
            $ref: '#/components/schemas/FeProjectResponse'
          type: array
          title: Items
        pagination:
          $ref: '#/components/schemas/PaginationInfo'
      type: object
      required:
        - items
        - pagination
      title: PaginationResponse[FeProjectResponse]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FeProjectResponse:
      properties:
        id:
          type: string
          title: Id
        created_at:
          type: string
          format: date-time
          title: Created At
        name:
          type: string
          title: Name
        organization_id:
          type: integer
          title: Organization Id
        highlighted_program_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Highlighted Program Id
        highlighted_program_pinned:
          type: boolean
          title: Highlighted Program Pinned
        created_by:
          type: string
          title: Created By
        program_count:
          type: integer
          title: Program Count
        total_proofs_run:
          type: integer
          title: Total Proofs Run
        last_active_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Active At
        total_usage_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Usage Count
        is_favorite:
          type: boolean
          title: Is Favorite
      type: object
      required:
        - id
        - created_at
        - name
        - organization_id
        - highlighted_program_id
        - highlighted_program_pinned
        - created_by
        - program_count
        - total_proofs_run
        - last_active_at
        - is_favorite
      title: FeProjectResponse
      description: User-facing project response model.
    PaginationInfo:
      properties:
        total:
          type: integer
          title: Total
        page:
          type: integer
          title: Page
        page_size:
          type: integer
          title: Page Size
        pages:
          type: integer
          title: Pages
      type: object
      required:
        - total
        - page
        - page_size
        - pages
      title: PaginationInfo
      description: Pagination metadata.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: Axiom-API-Key

````