> ## 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.

# List Metafield Definitions

> List metafield definitions for a store. Admin API only.

# List Metafield Definitions

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

Returns paginated metafield definitions for the merchant's store.

## Request

```bash theme={null}
curl -G "https://api.launchmystore.io/metafield-definitions" \
  -H "Authorization: Bearer <merchant-jwt>" \
  --data-urlencode "ownerType=product" \
  --data-urlencode "pinned=true"
```

## Auth

Merchant JWT (owner, or staff with admin/manager access).

## Query parameters

<ParamField query="ownerType" type="string">
  Filter by owner type (`shop`, `product`, `variant`, `collection`,
  `customer`, `order`, `page`, `blog`, `article`).
</ParamField>

<ParamField query="namespace" type="string">
  Filter by namespace.
</ParamField>

<ParamField query="key" type="string">
  Filter by exact key.
</ParamField>

<ParamField query="pinned" type="boolean">
  Filter to only pinned (or only unpinned) definitions.
</ParamField>

<ParamField query="page" type="integer" default="1">
  1-indexed page number.
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Items per page.
</ParamField>

## Response

```json theme={null}
{
  "status": 200,
  "state": "success",
  "data": {
    "definitions": [
      {
        "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"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 50
  }
}
```

## Error codes

| Code           | Description                     |
| -------------- | ------------------------------- |
| `UNAUTHORIZED` | Invalid or missing JWT          |
| `FORBIDDEN`    | Wrong store / insufficient role |