---
title: "List content Blocks"
method: GET
path: "/buckets/{slug}/blocks"
tags: ["Blocks"]
---

# List content Blocks

`GET /buckets/{slug}/blocks`

Retrieve the content Blocks configured on the Bucket. Returns an empty array when the Bucket has none.

## Query parameters

- `read_key` string
- `pretty` boolean

## Response `200`

The Bucket's content Blocks.

- BlocksResponse
  - `blocks` object[], required — The Bucket's content Blocks. Empty when none are configured.

## Other responses

- `401` — The access key is missing or incorrect.
- `402` — The Bucket needs to be upgraded before it can be used again.
- `404` — The addressed resource does not exist in this Bucket. Note that this covers a resource missing from a route that exists; an unrecognized route answers 200 with a `Route not found` body instead, as described in the API description above.
- `429` — Too many requests hit the API too quickly. Back off and retry.
- `500` — Something went wrong on the Cosmic side.

---

[API](https://skmtc.dev/cosmicjs/apis/cosmic-rest-api-v3.md) · [All operations](https://skmtc.dev/cosmicjs/apis/cosmic-rest-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cosmicjs/cosmic-rest-api-v3/revisions/e0aa2a0913b3/schema)