> ## Documentation Index > Fetch the complete documentation index at: https://docs.rainbrand.com/llms.txt > Use this file to discover all available pages before exploring further. # List models > Discover available generation models. Filter by type or query, and use limit and cursor to page through results. This feature is in beta. During beta, endpoint schemas and behavior may change or be removed. ## OpenAPI ````yaml https://www.rainbrand.com/api/v1/spec.json get /models openapi: 3.1.1 info: title: Rainbrand API version: 1.0.0 servers: - url: https://www.rainbrand.com/api/v1 security: - apiKey: [] - bearer: [] tags: - name: Uploads description: >- Stage private local files for brand sources, the Library, and other supported operations. - name: Account description: >- Inspect the authenticated account — profile, credit balance, and accessible workspaces. - name: Brands description: Manage brands and brand identity. - name: Library description: Add, list, and remove a brand's images, video, and audio. - name: Images description: Retrieve and manage images. - name: Videos description: Retrieve and manage video files. - name: Audio description: Retrieve and manage audio files. - name: Briefs description: Get brand guidance and selected assets for a specific task. - name: Models description: Find available models and check their inputs. - name: Generations description: Create and retrieve model generations. - name: Reviews description: >- Check an asset against a brand's color, typography, logo, and copy guidance. paths: /models: get: tags: - Models summary: List models description: >- Discover available generation models. Filter by type or query, and use limit and cursor to page through results. operationId: models.list parameters: - name: type in: query schema: enum: - image - video - audio - svg type: string description: Filter by the type of file the model generates. allowEmptyValue: true allowReserved: true - name: query in: query schema: type: string maxLength: 200 description: Search available models. allowEmptyValue: true allowReserved: true - name: limit in: query schema: type: integer minimum: 1 maximum: 50 default: 20 description: Maximum number of models to return. Accepts 1–50; defaults to 20. allowEmptyValue: true allowReserved: true - name: cursor in: query schema: type: string description: >- Cursor for the next page. Keep type and query unchanged when using a cursor. allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: data: type: object properties: models: type: array items: type: object properties: id: type: string description: >- Exact model ID. Use this value when fetching model details or starting a generation. provider: type: string description: Provider that offers the model. name: type: string description: Display name of the model. type: enum: - image - video - audio - svg type: string description: Type of file the model generates. capabilities: type: array minItems: 1 items: enum: - text-to-image - image-to-image - text-to-video - image-to-video - audio-to-video - video-to-video - text-to-speech - music-generation - text-to-svg type: string description: >- Machine-readable tags identifying the model’s supported operations, such as `text-to-image` or `image-to-video`. description: type: string description: Description of the model and its capabilities. required: - id - provider - name - type - capabilities - description description: Models matching the filters on this page. nextCursor: anyOf: - type: string - type: 'null' description: >- Pass this value as cursor to get the next page. Null when there are no more results. hasMore: type: boolean description: Whether another page of models is available. required: - models - nextCursor - hasMore required: - data '400': description: '400' content: application/json: schema: $ref: '#/components/schemas/ModelsList400ErrorResponse' '401': description: '401' content: application/json: schema: $ref: '#/components/schemas/ModelsList401ErrorResponse' '403': description: '403' content: application/json: schema: $ref: '#/components/schemas/ModelsList403ErrorResponse' '429': description: '429' content: application/json: schema: $ref: '#/components/schemas/ModelsList429ErrorResponse' headers: Retry-After: description: >- Seconds until the applicable request or operation limit resets. Present when the limiter can calculate the delay. schema: type: integer minimum: 0 '503': description: '503' content: application/json: schema: $ref: '#/components/schemas/ModelsList503ErrorResponse' components: schemas: ModelsList400ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: INVALID_CURSOR status: const: 400 message: type: string default: Invalid generation model cursor data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ModelsList401ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: UNAUTHORIZED status: const: 401 message: type: string default: Invalid or missing API credentials data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ModelsList403ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: ACCOUNT_BANNED status: const: 403 message: type: string default: This account has been suspended. data: {} required: - code - status - message - type: object properties: code: const: FORBIDDEN status: const: 403 message: type: string default: Plan upgrade required data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ModelsList429ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: TOO_MANY_REQUESTS status: const: 429 message: type: string default: Rate limit exceeded data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ModelsList503ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: CATALOG_UNAVAILABLE status: const: 503 message: type: string default: Could not load generation models data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ApiError: type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: 'Rainbrand API key, for example `x-api-key: bloom_sk_...`.' bearer: type: http scheme: bearer description: >- Rainbrand API key (`Bearer bloom_sk_...`) or Rainbrand OAuth access token. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.