> ## 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. # Get a generation > Get a generation's current status and any completed files. While processing, wait retryAfterSeconds before checking again. Failed generations include error details. Each successful check of a completed generation returns fresh download links valid for seven days. Generation records expire after 30 days. This endpoint returns immediately and does not support wait. ## OpenAPI ````yaml https://www.trybloom.ai/api/v1/spec.json get /generations/{id} 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: Account description: >- Inspect the authenticated account — profile, credit balance, and accessible workspaces. - name: Brands description: Manage brands and brand identity. - name: Images description: Generate, edit, and retrieve images. - name: Models description: Find available models and check their inputs. - name: Generations description: Generate images, video, audio, and SVG, then retrieve the results. - name: Uploads description: >- Stage private local files for Brand sources, Library images, and other supported operations. paths: /generations/{id}: get: tags: - Generations summary: Get a generation description: >- Get a generation's current status and any completed files. While processing, wait retryAfterSeconds before checking again. Failed generations include error details. Each successful check of a completed generation returns fresh download links valid for seven days. Generation records expire after 30 days. This endpoint returns immediately and does not support wait. operationId: generations.get parameters: - name: id in: path required: true schema: type: string format: uuid description: Generation ID returned by POST /generations. responses: '200': description: OK content: application/json: schema: type: object properties: data: anyOf: - type: object properties: generationId: type: string format: uuid description: ID of this generation. type: enum: - image - video - audio - svg type: string description: Type of file requested. model: type: string description: Exact ID of the model used for this generation. status: const: processing description: The generation is still running. retryAfterSeconds: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 description: >- Number of seconds to wait before checking this generation again. required: - generationId - type - model - status - retryAfterSeconds - type: object properties: generationId: type: string format: uuid description: ID of this generation. type: enum: - image - video - audio - svg type: string description: Type of file requested. model: type: string description: Exact ID of the model used for this generation. status: const: completed description: >- The generation finished and its files are available. artifacts: type: array items: type: object properties: url: type: string format: uri description: >- Temporary download link valid for seven days. Request the completed generation again to get a fresh link while its record is available. mimeType: type: string description: >- File format expressed as a MIME type, such as image/jpeg. expiresAt: type: string format: date-time description: Time when this download link expires. required: - url - mimeType - expiresAt description: Generated files available to download. required: - generationId - type - model - status - artifacts - type: object properties: generationId: type: string format: uuid description: ID of this generation. type: enum: - image - video - audio - svg type: string description: Type of file requested. model: type: string description: Exact ID of the model used for this generation. status: const: failed description: The generation failed. Check error for details. error: type: object properties: code: const: upstream_failed description: >- Failure code. upstream_failed means the generation failed after the request was accepted. message: type: string description: Explanation of the failure. retryable: type: boolean description: >- Whether the failure may succeed on another attempt. Retrying requires submitting a new generation. required: - code - message - retryable description: Details of the generation failure. required: - generationId - type - model - status - error required: - data '401': description: '401' content: application/json: schema: $ref: '#/components/schemas/GenerationsGet401ErrorResponse' '403': description: '403' content: application/json: schema: $ref: '#/components/schemas/GenerationsGet403ErrorResponse' '404': description: '404' content: application/json: schema: $ref: '#/components/schemas/GenerationsGet404ErrorResponse' '429': description: '429' content: application/json: schema: $ref: '#/components/schemas/GenerationsGet429ErrorResponse' 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: GenerationsGet401ErrorResponse: 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 GenerationsGet403ErrorResponse: 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 GenerationsGet404ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: GENERATION_NOT_FOUND status: const: 404 message: type: string default: Generation not found data: {} required: - code - status - message - type: object properties: code: const: BRAND_NOT_FOUND status: const: 404 message: type: string default: Brand not found data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error GenerationsGet429ErrorResponse: 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. ````