# List paths for static generation

**Publié le** : 2026-05-12
**Catégorie** : Storefront API

## `GET /paths`

**List paths for static generation**

Return every renderable path on the site (content slugs, category
paths) for the active `blogUrlMode`. Useful for static-site
generators and sitemap consumers that need the exhaustive route map.

### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |


> **Notes:** Cache: `Cache-Control: public, max-age=300`. Rate-limit bucket:
> general. Envelope deviates from the `{ data }` wrap: top-level keys
> are `paths`, `blogUrlMode`, `locale`.

### Examples

```curl
curl "https://api.lynkow.com/public/{siteId}/paths?locale=en"
```

```javascript
const res = await fetch(`https://api.lynkow.com/public/${siteId}/paths?locale=en`)
const { paths, blogUrlMode, locale } = await res.json()
```

### Response Example

```json
"{\n  \"paths\": [\n    { \"type\": \"category\", \"path\": \"/blog/engineering\", \"slug\": \"engineering\", \"locale\": \"en\" },\n    { \"type\": \"content\", \"path\": \"/blog/engineering/how-we-set-our-pricing\", \"slug\": \"how-we-set-our-pricing\", \"locale\": \"en\" }\n  ],\n  \"blogUrlMode\": \"with-categories\",\n  \"locale\": \"en\"\n}\n"
```

---