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

# Asset Meta

> Return canonical metadata and file URLs for one indexed asset by its asset_id, including the structured rights object and available dimensions and formats. Delivery is separate from search, and returned URLs include the query ID so downloads can be attributed to their search.



## OpenAPI

````yaml /openapi.json get /v1/asset/{asset_id}
openapi: 3.1.0
info:
  title: Lightdrift API
  version: '1.3'
  description: >-
    Natural-language image search for agents. Describe what you want — in text,
    with a reference image, or both — and get ranked images back, each with a
    machine-readable rights answer. Retrieval only: no generation, no checkout.
servers:
  - url: https://api.lightdrift.ai
    description: Production
security:
  - apiKey: []
paths:
  /v1/asset/{asset_id}:
    get:
      summary: Asset Meta
      description: >-
        Return canonical metadata and file URLs for one indexed asset by its
        asset_id, including the structured rights object and available
        dimensions and formats. Delivery is separate from search, and returned
        URLs include the query ID so downloads can be attributed to their
        search.
      operationId: asset_meta_v1_asset__asset_id__get
      parameters:
        - name: asset_id
          in: path
          required: true
          schema:
            type: string
            title: Asset Id
      responses:
        '200':
          description: Asset metadata and file links.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetResponse'
              example:
                asset_id: isorepublic:17191
                title: Mini in Brooklyn
                source: isorepublic
                width: 4000
                height: 2667
                format: jpeg
                file: https://api.lightdrift.ai/v1/asset/direct/isorepublic:17191
                thumb: >-
                  https://api.lightdrift.ai/v1/asset/direct/isorepublic:17191?v=thumb
                rights:
                  license: cc0
                  license_verbatim: CC0 1.0
                  commercial: true
                  attribution_required: false
                  derivatives: true
                  share_alike: false
                  attribution: null
                  provenance_url: https://isorepublic.com/photo/mini-in-brooklyn/
                  basis: as-declared by source; verify for critical use
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AssetResponse:
      type: object
      properties:
        asset_id:
          type: string
        title:
          type: string
        source:
          type: string
        width:
          type: integer
        height:
          type: integer
        format:
          type: string
        file:
          type: string
        thumb:
          type: string
        rights:
          type: object
          properties:
            license:
              type: string
            license_verbatim:
              type: string
            commercial:
              type: boolean
            attribution_required:
              type: boolean
            derivatives:
              type: boolean
            share_alike:
              type: boolean
            attribution:
              type:
                - string
                - 'null'
            provenance_url:
              type: string
            basis:
              type: string
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your Lightdrift API key. Usage is metered per query.

````

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