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

# List Backgrounds or Foregrounds

> Your uploaded backgrounds or foregrounds, newest first, each with a signed URL that reads the image (a PNG) until url_expires_at, an hour on. Anyone holding the URL can read that one image until then, so keep it to your own app. List again for fresh URLs.



## OpenAPI

````yaml https://api.simli.ai/openapi.yaml get /assets/{kind}
openapi: 3.1.0
info:
  title: Simli
  version: 1.0.0
servers:
  - url: https://api.simli.ai/
    description: API server
security:
  - ApiKeyAuth: []
paths:
  /assets/{kind}:
    get:
      summary: List Backgrounds or Foregrounds
      description: >-
        Your uploaded backgrounds or foregrounds, newest first, each with a
        signed URL that reads the image (a PNG) until url_expires_at, an hour
        on. Anyone holding the URL can read that one image until then, so keep
        it to your own app. List again for fresh URLs.
      operationId: listAssets_assets__kind__get
      parameters:
        - name: kind
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/AssetKind'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ListedAsset'
        '401':
          description: Unauthorized
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AssetKind:
      type: string
      enum:
        - backgrounds
        - foregrounds
      title: AssetKind
    ListedAsset:
      allOf:
        - $ref: '#/components/schemas/Asset'
        - type: object
          properties:
            url:
              anyOf:
                - type: string
                  format: uri
                - type: 'null'
              title: Url
              description: >-
                A signed URL that GETs the image until url_expires_at; usable as
                an <img> src. Null if one couldn't be made just then.
            url_expires_at:
              type: integer
              title: Url Expires At
              description: Unix time, in seconds, when url stops working.
          required:
            - url
            - url_expires_at
      title: ListedAsset
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Asset:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: What background_id / foreground_id and BG_ / FG_ take.
        name:
          type: string
          title: Name
          description: The uploaded file's name.
        width:
          type: integer
          title: Width
        height:
          type: integer
          title: Height
        size_bytes:
          type: integer
          title: Size Bytes
          description: The stored PNG's size.
        created_at:
          type: integer
          title: Created At
          description: Unix time, in seconds.
      type: object
      required:
        - id
        - name
        - width
        - height
        - size_bytes
        - created_at
      title: Asset
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-simli-api-key

````

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