> ## 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 Asset By Id

> Fetch detailed metadata for one media asset by its unique ID. This allows you to access detailed information about a specific asset by providing its unique asset ID.

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/{id}
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/{id}:
    get:
      summary: Retrieve a Single Asset
      description: >-
        Fetch detailed metadata for one media asset by its unique ID. This
        allows you to access detailed information about a specific asset by
        providing its unique asset ID.
      parameters:
        - $ref: '#/components/parameters/TenantIdHeader'
        - $ref: '#/components/parameters/WorkspaceIdHeader'
        - $ref: '#/components/parameters/EnvironmentIdHeader'
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Unique identifier of the asset to retrieve.
        - $ref: '#/components/parameters/LocaleQryPrm'
      responses:
        '200':
          description: Successful response returning the asset’s details.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: success
                    description: Request outcome indicator.
                  Data:
                    type: object
                    properties:
                      records:
                        type: array
                        items:
                          $ref: '#/components/schemas/Asset'
                          description: >-
                            Full asset object, including URL, metadata, and
                            timestamps.
                      _meta_:
                        type: object
                        description: Contextual metadata about the request.
                        properties:
                          tenant_id:
                            type: string
                            description: Identifier of the tenant.
                          workspace_id:
                            type: string
                            description: Identifier of the workspace.
                          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 `id` format or missing required parameter.
          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
  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

````