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

# Get All Assets

> Retrieve a paginated list of all media assets (images, videos, documents, etc.) stored in your workspace. Use sorting, pagination, and locale options to tailor the response according to your requirement.

Before calling this endpoint, make sure you’ve generated an API token and picked the correct domain. See [Authentication & Base URLs](/api-reference/authbaseurl).


## OpenAPI

````yaml GET /assets/v2
openapi: 3.1.0
info:
  title: OpenAPI Plant Store
  description: >-
    A sample API that uses a plant store as an example to demonstrate features
    in the OpenAPI specification
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://apis.experro.app
    description: Admin Server
  - url: https://{base-address}
    description: Custom Server
    variables:
      base-address:
        default: ''
        description: Enter your custom domain or server address.
security:
  - bearerAuth: []
paths:
  /assets/v2:
    get:
      summary: List All Assets
      description: >-
        Retrieve a paginated list of all media assets (images, videos,
        documents, etc.) stored in your workspace. Use sorting, pagination, and
        locale options to tailor the response according to your requirement.
      parameters:
        - $ref: '#/components/parameters/TenantIdHeader'
        - $ref: '#/components/parameters/WorkspaceIdHeader'
        - $ref: '#/components/parameters/EnvironmentIdHeader'
        - $ref: '#/components/parameters/LocaleQryPrm'
        - name: sort_order
          in: query
          schema:
            type: string
          description: >-
            Order in which to sort assets: `asc` (oldest first) or `desc`
            (newest first).
        - name: sort_by
          in: query
          schema:
            type: string
          description: Field used to sort the results.
        - $ref: '#/components/parameters/LimitQryPrm'
        - name: offset
          in: query
          schema:
            type: integer
          description: Skips the specified number of results from the beginning.
      responses:
        '200':
          description: A list of asset objects.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: success
                    description: Overall status of the request.
                  Data:
                    type: object
                    properties:
                      records:
                        type: array
                        description: Array of asset objects.
                        items:
                          $ref: '#/components/schemas/Asset'
                      _meta_:
                        type: object
                        description: Pagination and workspace metadata.
                        properties:
                          tenant_id:
                            type: string
                            description: Your tenant identifier.
                          workspace_id:
                            type: string
                            description: Your workspace identifier.
                          limit:
                            type: integer
                            description: Requested page size.
                          total_rows:
                            type: integer
                            description: Total number of assets available.
                          offset:
                            type: integer
                            description: Requested page offset.
        '400':
          description: Bad Request – invalid query parameters (e.g. `limit` out of range).
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: failure
                  Data:
                    $ref: '#/components/schemas/Error404'
        '401':
          description: Unauthorized – Missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: failure
                  Data:
                    $ref: '#/components/schemas/Error401'
        '500':
          description: Internal Server Error – an unexpected error on the server.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: failure
                  Data:
                    $ref: '#/components/schemas/Error500'
      servers:
        - url: https://apis.experro.app
          description: Admin Server
components:
  parameters:
    TenantIdHeader:
      name: x-tenant-id
      in: header
      required: true
      schema:
        type: string
      description: Identifier for the tenant. Ensures data isolation per tenant.
    WorkspaceIdHeader:
      name: x-workspace-id
      in: header
      required: true
      schema:
        type: string
      description: >-
        Workspace identifier within the tenant. Scopes resources to a specific
        workspace.
    EnvironmentIdHeader:
      name: x-environment-id
      in: header
      required: true
      schema:
        type: string
        example: PRODUCTION-15a0f8c2-a5e8-4e40-ae74-cb1389d22f45-w49jkngj
      description: >-
        Unique identifier of the target environment. Used to scope the API call
        to a specific deployment environment.
    LocaleQryPrm:
      name: locale
      in: query
      description: Specifies the language or region for the response data
      required: true
      schema:
        type: string
    LimitQryPrm:
      name: limit
      in: query
      schema:
        type: integer
      description: Maximum number of items to return.
  schemas:
    Asset:
      type: object
      description: >-
        Represents a media asset stored in the system (image, video, document)
        including its storage metadata.
      properties:
        tenant_id:
          type: string
          format: uuid
          description: Tenant to which this asset belongs.
        workspace_id:
          type: string
          format: uuid
          description: Workspace to which this asset belongs.
        folder_id:
          type: string
          format: uuid
          description: Identifier of the folder containing this asset.
        alt_text:
          type:
            - string
            - 'null'
          description: Alternative text for accessibility.
        caption:
          type:
            - string
            - 'null'
          description: Optional caption displayed with the asset.
        size:
          type: string
          description: Size of the asset file.
        created_at:
          type: string
          format: date-time
          description: Timestamp when the asset was uploaded.
        created_by:
          type: string
          format: uuid
          description: User who uploaded the asset.
        modified_at:
          type: string
          format: date-time
          description: Timestamp of last update to asset metadata.
        modified_by:
          type: string
          format: uuid
          description: User who last modified the asset metadata.
        id:
          type: string
          format: uuid
          description: Unique identifier of the asset.
        relative_path:
          type: string
          description: Path within the storage container.
        public_url:
          type: string
          description: Publicly accessible URL for the asset.
          format: uri
      required:
        - tenant_id
        - workspace_id
        - folder_id
        - size
        - created_at
        - created_by
        - modified_at
        - modified_by
        - id
        - relative_path
        - public_url
    Error404:
      type: object
      properties:
        Status:
          type: string
          example: failure
        Error:
          type: object
          properties:
            message:
              type: string
            name:
              type: string
            code:
              type: string
          required:
            - message
            - name
      required:
        - Status
        - Error
    Error401:
      type: object
      properties:
        Status:
          type: string
          example: failure
        Error:
          type: object
          properties:
            message:
              type: string
            name:
              type: string
            code:
              type: string
          required:
            - message
            - name
      required:
        - Status
        - Error
    Error500:
      type: object
      properties:
        Status:
          type: string
          example: failure
        Error:
          type: object
          properties:
            message:
              type: string
            name:
              type: string
            code:
              type: string
          required:
            - message
            - name
      required:
        - Status
        - Error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````