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

# Get Metafield Definition

> Fetch one metafield definition by id. Admin API only.

# Get Metafield Definition

<Warning>
  Admin API only — requires a merchant JWT. Not exposed to OAuth apps.
</Warning>

## Request

```bash theme={null}
curl "https://api.launchmystore.io/metafield-definitions/<id>" \
  -H "Authorization: Bearer <merchant-jwt>"
```

## Path parameters

<ParamField path="id" type="string" required>
  The definition UUID.
</ParamField>

## Response

```json theme={null}
{
  "status": 200,
  "state": "success",
  "data": {
    "id": "f7e3a920-...",
    "namespace": "custom",
    "key": "warranty_years",
    "name": "Warranty (years)",
    "description": "How many years of warranty are included",
    "type": "number_integer",
    "owner_type": "product",
    "validations": { "min": 0, "max": 25 },
    "pinned": true,
    "app_id": null,
    "created_at": "2026-05-09T13:30:00.000Z",
    "updated_at": "2026-05-09T13:30:00.000Z"
  }
}
```

## Error codes

| Code           | Description                     |
| -------------- | ------------------------------- |
| `UNAUTHORIZED` | Invalid or missing JWT          |
| `FORBIDDEN`    | Wrong store / insufficient role |
| `NOT_FOUND`    | Definition does not exist       |