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

# List models

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the AI models you can pick for a product, in the order the model picker shows them. The Automatic entry, whose `id` is `default`, always comes first.

The list is resolved for the caller, so two people can get different lists. Call this with the same credentials you use to send messages, so that every model you offer is one that caller can use.

Models are added and retired over time. Read the list when you render a picker instead of storing model IDs in your code.

Results use cursor-based pagination. A cursor works only for the caller and `product` it was issued for.



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/ai/model-catalog
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/ai/model-catalog:
    get:
      summary: List models
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns the AI models you can pick for a product, in the order the model
        picker shows them. The Automatic entry, whose `id` is `default`, always
        comes first.


        The list is resolved for the caller, so two people can get different
        lists. Call this with the same credentials you use to send messages, so
        that every model you offer is one that caller can use.


        Models are added and retired over time. Read the list when you render a
        picker instead of storing model IDs in your code.


        Results use cursor-based pagination. A cursor works only for the caller
        and `product` it was issued for.
      operationId: get_model_catalog_for_current_user_api_ai_model_catalog_get
      parameters:
        - name: product
          in: query
          required: true
          schema:
            enum:
              - builder
              - superagent
            type: string
            description: >-
              Product whose model picker to list. Either `"builder"` for the app
              editor's AI chat or `"superagent"`.
            title: Product
          description: >-
            Product whose model picker to list. Either `"builder"` for the app
            editor's AI chat or `"superagent"`.
          example: builder
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            description: Pagination cursor from previous response.
            title: Cursor
          description: Pagination cursor from previous response.
          example: gAAAAABn7vJ0q2kX
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Items per page. Max 100. Defaults to 50.
            default: 50
            title: Limit
          description: Items per page. Max 100. Defaults to 50.
          example: 20
      responses:
        '200':
          description: One page of the models the caller can pick.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelCatalogResponse'
              example:
                models:
                  - id: claude_fable_5_1
                    label: Fable 5.1
                    provider: anthropic
                    is_new: false
                    uses_more_credits: true
                    is_best: false
                    effort_levels:
                      - low
                      - medium
                      - high
                      - xhigh
                      - max
                    more_models: true
        '400':
          description: >-
            `cursor` is invalid, was issued for another caller or `product`, or
            names a model that is no longer listed (`invalid_cursor`). Or the
            credential was sent in the URL instead of the `Authorization` header
            (`credentials_in_query`).
          content:
            application/json:
              examples:
                invalid_cursor:
                  summary: invalid_cursor
                  value:
                    error:
                      code: invalid_cursor
                      message: This cursor names a model that is no longer listed
                      details: {}
                credentials_in_query:
                  summary: credentials_in_query
                  value:
                    error:
                      code: credentials_in_query
                      message: >-
                        Send your credential in the Authorization header, not in
                        the URL.
                      details: {}
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
        '401':
          description: Missing or invalid credentials (`unauthenticated`).
          content:
            application/json:
              examples:
                unauthenticated:
                  summary: unauthenticated
                  value:
                    error:
                      code: unauthenticated
                      message: Not authenticated
                      details: {}
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
        '422':
          description: >-
            `product` is missing or isn't a supported value, or `limit` is out
            of range (`invalid_request`).
          content:
            application/json:
              examples:
                invalid_request:
                  summary: invalid_request
                  value:
                    error:
                      code: invalid_request
                      message: Invalid request
                      details: {}
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
        '429':
          description: >-
            Too many requests (`rate_limited`). The limit is 120 requests per 60
            seconds for each caller, on every plan. Retry after the
            `Retry-After` seconds.
          content:
            application/json:
              examples:
                rate_limited:
                  summary: rate_limited
                  value:
                    error:
                      code: rate_limited
                      message: Rate limit exceeded.
                      details: {}
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
        '503':
          description: >-
            Database temporarily unavailable (`database_unavailable`): the data
            cluster did not answer in time. Retry after the `Retry-After`
            seconds.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
              examples:
                database_unavailable:
                  summary: database_unavailable
                  value:
                    error:
                      code: database_unavailable
                      message: Database temporarily unavailable, please retry
                      details: {}
      security:
        - PersonalAccessTokenAuth:
            - read_only
        - WorkspaceApiKeyAuth:
            - read_only
        - WorkspaceApiKeyBearerAuth:
            - read_only
components:
  schemas:
    ModelCatalogResponse:
      properties:
        models:
          items:
            $ref: '#/components/schemas/CatalogModel'
          type: array
          title: Models
          description: Models on this page, in the order the model picker shows them.
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
          description: >-
            Cursor for fetching the next page. The value is `null` if there are
            no more pages.
          example: gAAAAABn7vJ0q2kX
      type: object
      required:
        - models
      title: ModelCatalogResponse
    StandardErrorEnvelope:
      properties:
        error:
          $ref: '#/components/schemas/StandardError'
          description: What went wrong.
      type: object
      required:
        - error
      title: StandardErrorEnvelope
      description: The error body returned in the standard envelope.
    CatalogModel:
      properties:
        id:
          type: string
          title: Id
          description: >-
            ID of the model. `default` is the Automatic entry, which lets Base44
            choose.
          example: claude_fable_5_1
        label:
          type: string
          title: Label
          description: Display name of the model.
          example: Fable 5.1
        provider:
          type: string
          enum:
            - auto
            - base44
            - anthropic
            - google
            - openai
            - zai
            - unknown
          title: Provider
          description: >-
            Company that makes the model: `"auto"`, `"base44"`, `"anthropic"`,
            `"google"`, `"openai"`, `"zai"`, or `"unknown"`. The Automatic entry
            is `"auto"`.
          example: anthropic
        is_new:
          type: boolean
          title: Is New
          description: >-
            Whether the model launched in the last 7 days. The value is `true`
            during that week and `false` after it.
          example: false
        uses_more_credits:
          type: boolean
          title: Uses More Credits
          description: >-
            Whether the model uses noticeably more credits than the others. The
            value is `true` when it does and `false` when it doesn't.
          example: true
        is_best:
          type: boolean
          title: Is Best
          description: >-
            Whether the model is a premium pick that needs a plan with manual
            model selection. The value is `true` only on such models when
            `product` is `superagent`, and `false` otherwise.
          example: false
        effort_levels:
          items:
            $ref: '#/components/schemas/EffortLevel'
          type: array
          title: Effort Levels
          description: >-
            Reasoning effort levels the model offers besides `"auto"`, lowest
            first: `"low"`, `"medium"`, `"high"`, `"xhigh"`, or `"max"`. The
            list is empty when the model offers no choice.
          default: []
          example:
            - low
            - medium
            - high
            - xhigh
            - max
        more_models:
          type: boolean
          title: More Models
          description: >-
            Whether the app editor lists the model under its collapsed More
            models group. The value is `true` when it does and `false` when the
            model is in the main list. It is always `false` when `product` is
            `superagent`.
          default: false
          example: true
      type: object
      required:
        - id
        - label
        - provider
        - is_new
        - uses_more_credits
        - is_best
      title: CatalogModel
    StandardError:
      properties:
        code:
          type: string
          title: Code
          description: >-
            Stable machine-readable cause of the failure. Match on this, not on
            `message`.
          example: not_found
        message:
          type: string
          title: Message
          description: Human-readable explanation. It isn't a stable contract.
          example: App not found
        details:
          additionalProperties: true
          type: object
          title: Details
          description: >-
            Structured context for the failure, or an empty object when there's
            none.
          example: {}
      type: object
      required:
        - code
        - message
      title: StandardError
    EffortLevel:
      type: string
      enum:
        - auto
        - low
        - medium
        - high
        - xhigh
        - max
      title: EffortLevel
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: >-
        Personal access token, sent as `Authorization: Bearer <token>`. Each
        operation lists the permission it needs: `read_only` or `full_access`. A
        full-access token can call every operation. A read-only token can call
        only the operations that list `read_only`; anything else returns 403
        `read_only_credential_route_not_allowed`.
    WorkspaceApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: >-
        Workspace API key, sent as `api_key: <key>`. Each operation that accepts
        one lists what the key needs: a permission, `read_only` or
        `full_access`, like a personal access token, or a scope. A key without
        the scope gets 403 `workspace_api_key_scope_required`.
    WorkspaceApiKeyBearerAuth:
      type: http
      scheme: bearer
      description: >-
        Workspace API key, sent as `Authorization: Bearer <key>`. Accepted
        wherever `api_key` is, with the same permission.

````

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