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

# Primitives

> Read primitive scales (spacing, typography, etc.) via the Humic API.

## List primitives

Returns all primitives grouped by type.

<ParamField query="type" type="string" optional>
  Filter by primitive type (e.g., `spacing`, `font.size`, `radius`).
</ParamField>

```bash theme={null}
curl https://humic.dev/api/v1/primitives \
  -H "Authorization: Bearer sk_live_your_key"
```

```json theme={null}
{
  "data": {
    "primitives": {
      "spacing": [
        { "key": "xs", "value": 4, "unit": "px" },
        { "key": "sm", "value": 8, "unit": "px" },
        { "key": "md", "value": 16, "unit": "px" },
        { "key": "lg", "value": 24, "unit": "px" }
      ],
      "radius": [
        { "key": "sm", "value": 4, "unit": "px" },
        { "key": "md", "value": 8, "unit": "px" }
      ],
      "font.size": [
        { "key": "sm", "value": 14, "unit": "px" },
        { "key": "base", "value": 16, "unit": "px" },
        { "key": "lg", "value": 18, "unit": "px" }
      ],
      "font.weight": [
        { "key": "normal", "value": 400, "unit": null },
        { "key": "bold", "value": 700, "unit": null }
      ],
      "font.family": [
        { "key": "sans", "value": "Inter", "unit": null },
        { "key": "mono", "value": "JetBrains Mono", "unit": null }
      ],
      "opacity": [
        { "key": "disabled", "value": 0.4, "unit": null }
      ],
      "duration": [
        { "key": "fast", "value": 100, "unit": "ms" },
        { "key": "normal", "value": 200, "unit": "ms" }
      ],
      "z-index": [
        { "key": "dropdown", "value": 10, "unit": null },
        { "key": "modal", "value": 50, "unit": null }
      ]
    }
  }
}
```

### Primitive types

| Type                 | Value    | Unit |
| -------------------- | -------- | ---- |
| `spacing`            | `number` | `px` |
| `radius`             | `number` | `px` |
| `font.size`          | `number` | `px` |
| `font.weight`        | `number` | —    |
| `font.family`        | `string` | —    |
| `font.lineHeight`    | `number` | —    |
| `font.letterSpacing` | `number` | `em` |
| `opacity`            | `number` | —    |
| `duration`           | `number` | `ms` |
| `easing`             | `string` | —    |
| `shadow`             | `string` | `px` |
| `z-index`            | `number` | —    |