---
title: "Browse transcriptions hierarchically"
method: GET
path: "/transcriptions/browse.json"
tags: ["Transcriptions"]
---

# Browse transcriptions hierarchically

`GET /transcriptions/browse.json`

## Request

- Base URL: `https://api.openarchieven.nl/1.1`
- URL: `https://api.openarchieven.nl/1.1/transcriptions/browse.json`
- Auth: none declared

Returns a hierarchical browse of available page transcriptions. Mirrors `/transcripties/lijst/`. Three modes, depending on the supplied filters:

  * No filter — top-level list of source archives ordered by total
    transcription count (descending).
  * `archive_code` — list of all archive numbers (archieftoegangen)
    within that archive, ordered by archive number.
  * `archive_code` + `archive_number` — list of all inventories
    within that archive number, ordered by inventory number.

The order of items is fixed and cannot be overridden. Results are always returned in full (no paging).

## Query parameters

- `archive_code` string
- `archive_number` string
- `lang` 'nl' | 'en' | 'de' | 'fr'
- `callback` string

## Response `200`

Successful browse response

- TranscriptionBrowseResponse: Response returned by `/transcriptions/browse.json`.
  - `filters` object, required
    - `archive_code` string, nullable
    - `archive_number` string, nullable
  - `response` object, required
    - `level` 1 | 2 | 3: Browse depth: 1 = source archives, 2 = archive numbers within an archive, 3 = inventories within an archive number.
    - `docs` union[]: Item shape depends on `level`. At level 1 each item is a `TranscriptionBrowseLevel1Item`; at levels 2 and 3 each item is a `TranscriptionBrowseNumberedItem`.
      - union
        - TranscriptionBrowseLevel1Item
          - `isil` string
          - `archive_code` string, nullable
          - `name` string, nullable
          - `count` integer
        - TranscriptionBrowseNumberedItem
          - `nr` string
          - `title` string
          - `count` integer
          - `url` string, uri: External URL describing this archive number or inventory on the source institution's website.

## Other responses

- `400`: Invalid parameters
- `429`: Too Many Requests — rate limit of 4 requests per second per IP exceeded.

---

[API](https://skmtc.dev/openarchieven/apis/open-archives-api.md) · [All operations](https://skmtc.dev/openarchieven/apis/open-archives-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openarchieven/apis/open-archives-api/revisions/4ff4685dd9e9?raw)