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

# Get Asset

> Retrieve a single asset by its ID.

## Path parameters

<ParamField path="id" type="string" required>
  The asset's unique identifier (UUID).
</ParamField>

## Response

<ResponseField name="asset" type="object" required>
  The asset object.

  <Expandable title="Asset properties">
    <ResponseField name="id" type="string" required>
      Unique asset identifier (UUID).
    </ResponseField>

    <ResponseField name="type" type="string" required>
      The asset type: `internal`, `external`, or `licence`.
    </ResponseField>

    <ResponseField name="name" type="string | null">
      Display name of the asset.
    </ResponseField>

    <ResponseField name="filename" type="string | null">
      Filename derived from the uploaded file or URL.
    </ResponseField>

    <ResponseField name="external_url" type="string | null">
      The external URL for `external` type assets. `null` for other types.
    </ResponseField>

    <ResponseField name="content_type" type="string | null">
      MIME type of the asset.
    </ResponseField>

    <ResponseField name="byte_size" type="integer" required>
      File size in bytes. `0` for external and licence assets.
    </ResponseField>

    <ResponseField name="watermark_asset" type="boolean" required>
      Whether watermarking is enabled for this asset.
    </ResponseField>

    <ResponseField name="autogenerate_licence_key" type="boolean" required>
      Whether a licence key is auto-generated on purchase.
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      ISO 8601 timestamp of when the asset was created.
    </ResponseField>

    <ResponseField name="updated_at" type="string" required>
      ISO 8601 timestamp of when the asset was last updated.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://app.filemonk.io/api/v1/external/assets/a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
    -H 'X-Auth-Token: fm_api_key_your_key_here'
  ```

  ```javascript Node.js theme={null}
  const assetId = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';
  const response = await fetch(
    `https://app.filemonk.io/api/v1/external/assets/${assetId}`,
    { headers: { 'X-Auth-Token': 'fm_api_key_your_key_here' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  asset_id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
  response = requests.get(
      f'https://app.filemonk.io/api/v1/external/assets/{asset_id}',
      headers={'X-Auth-Token': 'fm_api_key_your_key_here'}
  )
  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "asset": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "external",
      "name": "Photoshop Brushes Pack",
      "filename": "brushes-pack-v2.zip",
      "external_url": "https://cdn.example.com/files/brushes-pack-v2.zip",
      "content_type": "application/zip",
      "byte_size": 0,
      "watermark_asset": false,
      "autogenerate_licence_key": false,
      "created_at": "2026-03-01T14:30:00Z",
      "updated_at": "2026-03-01T14:30:00Z"
    }
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Asset not found"
  }
  ```
</ResponseExample>