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

# List plans

> This endpoint allows fetching a list of plans, newest first by creation time, each with the product that it belongs to.



## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/plans/
openapi: 3.1.0
info:
  title: API Reference
  version: '1.0'
  description: Aira API Reference
  x-logo:
    url: https://static.useaira.com/images/airalogo.svg
    backgroundColor: '#FFFFFF'
    altText: Aira Logo
servers:
  - url: https://api.useaira.com
    description: API base URL
security:
  - ApiKey: []
paths:
  /v1/plans/:
    get:
      tags:
        - Plans
      summary: List plans
      description: >-
        This endpoint allows fetching a list of plans, newest first by creation
        time, each with the product that it belongs to.
      parameters:
        - schema:
            type: string
          in: query
          name: search
          required: false
          description: Free-text search over the plan name, ignoring case and accents.
        - schema:
            type: integer
            default: 0
            minimum: 0
            maximum: 2147483647
          in: query
          name: offset
          required: false
          description: Number of items to skip before collecting the page.
        - schema:
            type: integer
            minimum: 1
            default: 100
            maximum: 100
          in: query
          name: limit
          required: false
          description: Maximum number of items to return per page.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      description: >-
                        Schema representing a plan, a reusable set of charges of
                        the catalog. A contract bills a plan through a plan
                        instance.
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: The unique identifier for this plan.
                        name:
                          type: string
                          minLength: 1
                          description: The name of the plan.
                        description:
                          description: >-
                            The description of the plan, or null when it has
                            none.
                          type:
                            - 'null'
                            - string
                        product:
                          type: object
                          description: The product that the plan belongs to.
                          properties:
                            id:
                              description: >-
                                The unique identifier of the product in our
                                system.
                              type: string
                              format: uuid
                            name:
                              description: The name of the product.
                              type: string
                              example: Platform subscription
                          required:
                            - id
                            - name
                          additionalProperties: false
                      required:
                        - id
                        - name
                        - description
                        - product
                      additionalProperties: false
                    description: A list of items.
                  hasMore:
                    description: Indicates if there are more items to fetch.
                    type: boolean
                required:
                  - items
                  - hasMore
                additionalProperties: false
        '429':
          description: >-
            The tenant reached one of its limits of reads: 20 reads in flight or
            50 reads per second.
          headers:
            Retry-After:
              schema:
                type: integer
              description: The seconds to wait before the next read.
            RateLimit-Limit:
              schema:
                type: integer
              description: >-
                The limit that the read hit: 20 for the reads in flight, 50 for
                the reads per second.
            RateLimit-Remaining:
              schema:
                type: integer
              description: The reads left under that limit, which is 0.
            RateLimit-Reset:
              schema:
                type: integer
              description: >-
                The seconds to wait before the next read, as in Retry-After. The
                limit of reads per second takes new reads in the next second,
                but the limit of reads in flight takes a new read only once one
                of the reads in flight ends.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: >-
                      A human-readable description of the limit that the read
                      hit
                  code:
                    type: string
                    enum:
                      - too_many_reads_in_flight
                      - too_many_reads_per_second
                    description: The limit that the read hit
                required:
                  - code
                  - message
                additionalProperties: false
components:
  securitySchemes:
    ApiKey:
      type: apiKey
      description: API Key Authentication.
      name: X-API-KEY
      in: header

````

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