---
title: "List all document blocks"
method: GET
path: "/document-blocks"
tags: ["DocumentBlock"]
---

# List all document blocks

`GET /document-blocks`

Returns a list of your document blocks. The document blocks are returned sorted by creation date, with the most recent document blocks appearing first.

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Success response

- DocumentBlockList — A object with a data property that contains an array of up to limit document blocks. Each entry in the array is a separate document block object. If no more document block are available, the resulting array will be empty.
  - `data` DocumentBlock[]
    - `id` integer
    - `name` string
    - `prefix` string
    - `custom_field1` string
    - `custom_field2` string
  - `total` integer
  - `per_page` integer
  - `current_page` integer
  - `last_page` integer
  - `prev_page_url` string
  - `next_page_url` string

## Other responses

- `400` — The request is malformed.
- `401` — Authorization information is missing or invalid.
- `422` — Validation errors occured.
- `500` — Internal server error.

---

[API](https://skmtc.dev/swaggerhub/apis/billingo-api-v3.md) · [All operations](https://skmtc.dev/swaggerhub/apis/billingo-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/swaggerhub/billingo-api-v3/revisions/03576cabefad/schema)