---
title: "Retrieve custom fields of an asset"
method: GET
path: "/assets/{asset_id}/custom-fields"
tags: ["Assets"]
---

# Retrieve custom fields of an asset

`GET /assets/{asset_id}/custom-fields`

## Request

- Base URL: `https://enterprise.knak.io/api/published/v1`
- URL: `https://enterprise.knak.io/api/published/v1/assets/{asset_id}/custom-fields`
- Auth: none declared
- TypeScript: <https://skmtc.dev/knak/apis/knak-enterprise-api/docs/assets/:asset_id/custom-fields/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the custom fields that are defined on a specific asset.

## Path parameters

- `asset_id` string, required

## Response `200`

OK

- AssetCustomFields
  - `data` object
    - `type` string
    - `id` string
    - `attributes` object
      - `asset_id` string
      - `custom_fields` CustomField[]
        - `label` string
        - `key` string
        - `value` string
        - `locked` boolean: Indicates if the custom field is locked by the brand.

## Other responses

- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: Not Found

---

[API](https://skmtc.dev/knak/apis/knak-enterprise-api.md) - [All operations](https://skmtc.dev/knak/apis/knak-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/knak/apis/knak-enterprise-api/revisions/31d2c94edfcc?raw)