# List site blocks

**Publié le** : 2026-05-08
**Catégorie** : Core CMS

## `GET /site-blocks`

**List site blocks**

Returns all site blocks. Supports filtering by type (`global` or `page`),
status, and tags.

Required permissions: `site_blocks.view`

### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Unauthorized — invalid or missing API token |
| `403` | Forbidden — insufficient permissions |


### Examples

```bash
curl https://api.lynkow.com/v1/site-blocks \
  -H "Authorization: Bearer $API_TOKEN"
```

### Response Example

```json
{
  "data": [
    {
      "id": 1,
      "name": "Header",
      "slug": "header",
      "type": "global",
      "status": "published",
      "locale": "en",
      "createdAt": "2025-01-05T09:00:00.000Z",
      "updatedAt": "2025-03-20T11:00:00.000Z"
    },
    {
      "id": 2,
      "name": "About Page",
      "slug": "about",
      "type": "page",
      "status": "published",
      "path": "/about",
      "locale": "en",
      "createdAt": "2025-01-10T14:00:00.000Z",
      "updatedAt": "2025-04-01T08:30:00.000Z"
    },
    {
      "id": 3,
      "name": "Footer",
      "slug": "footer",
      "type": "global",
      "status": "draft",
      "locale": "en",
      "createdAt": "2025-02-15T10:00:00.000Z",
      "updatedAt": "2025-02-15T10:00:00.000Z"
    }
  ],
  "meta": {
    "total": 3,
    "perPage": 15,
    "currentPage": 1,
    "lastPage": 1
  }
}
```

---