> ## Documentation Index > Fetch the complete documentation index at: https://docs.trybloom.ai/llms.txt > Use this file to discover all available pages before exploring further. # List generations > List your generations, newest first. Outputs that were later deleted stay listed with available set to false. This feature is in beta. During beta, endpoint schemas and behavior may change or be removed. ## OpenAPI ````yaml https://www.trybloom.ai/api/v1/spec.json get /generations openapi: 3.1.1 info: title: Bloom API version: 1.0.0 servers: - url: https://www.trybloom.ai/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: /generations: get: tags: - Generations summary: List generations description: >- List your generations, newest first. Outputs that were later deleted stay listed with available set to false. operationId: generations.list parameters: - name: brandSessionId in: query schema: type: string format: uuid description: Only list generations for this brand. allowEmptyValue: true allowReserved: true - name: type in: query schema: enum: - image - video - audio - svg type: string description: Only list generations of this type. allowEmptyValue: true allowReserved: true - name: limit in: query schema: type: integer minimum: 1 maximum: 100 default: 50 description: Results per page (1–100, default 50) allowEmptyValue: true allowReserved: true - name: cursor in: query schema: type: string description: Pagination cursor from a previous response's nextCursor allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: data: type: object properties: generations: type: array items: type: object properties: id: type: string format: uuid description: Generation ID returned when the request started. status: enum: - pending - generating - completed - failed type: string description: Current generation status. type: type: string description: >- Requested output type. Known values: image, video, audio, svg; more may be added. model: type: string description: Exact model ID returned by GET /models. brandSessionId: type: string format: uuid description: Brand the generation belongs to. outputs: type: array items: type: object properties: id: type: string format: uuid type: type: string url: type: string format: uri available: type: boolean mimeType: type: string required: - type - available - mimeType description: >- Output files in provider order. Empty until the generation completes. failure: anyOf: - type: object properties: code: const: upstream_failed message: type: string retryable: type: boolean description: >- True when sending the same request again, unchanged, may succeed. False when the request must change first, or when a video may still be finishing and already billed. providerMessage: anyOf: - type: string - type: 'null' description: >- The provider's explanation of why it rejected the request, with links and secrets removed. Null when the provider gave none, or when the failure concerns Bloom's own account or a provider-side error. Its wording can change. required: - code - message - retryable - providerMessage - type: 'null' description: >- Failure details, or null when generation has not failed. createdAt: type: string format: date-time description: Time the generation was created. required: - id - status - type - model - brandSessionId - outputs - failure - createdAt nextCursor: anyOf: - type: string - type: 'null' hasMore: type: boolean required: - generations - nextCursor - hasMore required: - data '401': description: '401' content: application/json: schema: $ref: '#/components/schemas/GenerationsList401ErrorResponse' '403': description: '403' content: application/json: schema: $ref: '#/components/schemas/GenerationsList403ErrorResponse' '429': description: '429' content: application/json: schema: $ref: '#/components/schemas/GenerationsList429ErrorResponse' headers: Retry-After: description: >- Seconds until the API-key request limit resets. Present only when the request-rate limiter can calculate the delay. schema: type: integer minimum: 0 components: schemas: GenerationsList401ErrorResponse: 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 GenerationsList403ErrorResponse: 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: const: BETA_ACCESS_REQUIRED status: const: 403 message: type: string default: >- Selected-model generation is not enabled for this account. data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error GenerationsList429ErrorResponse: 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 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: 'Bloom API key, for example `x-api-key: bloom_sk_...`.' bearer: type: http scheme: bearer description: Bloom API key (`Bearer bloom_sk_...`) or Bloom OAuth access token. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.