---
title: "List documents"
method: GET
path: "/api/v1/documents/{id4n}"
tags: ["Storage"]
---

# List documents

`GET /api/v1/documents/{id4n}`

Listing all documents of an id4n

## Path parameters

- `id4n` string, required

## Query parameters

- `owner` string
- `offset` integer
- `limit` integer

## Response `200`

OK

- PaginatedResponseOfDocument
  - `elements` Document[], required
    - `filename` string — File Name
    - `mimeType` string — Mime Type
    - `ownerOrganizationId` string — The organization's namespace which owns the document
    - `visibility` Visibility
      - `public` boolean — Document is publicly readable (if ID4N is owned by the same organization)
      - `sharedOrganizationIds` string[] — Document is readable by these organizations (independend of ID4N ownership)
  - `limit` integer, required — The number of returned elements
  - `offset` integer, required — Starting with the n-th element
  - `total` integer — The total number of elements

## Other responses

- `202` — Accepted
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method not allowed
- `406` — Not Acceptable
- `415` — Unsupported Media Type
- `500` — Internal Server Error

---

[API](https://skmtc.net/id4i/apis/id4i-api.md) · [All operations](https://skmtc.net/id4i/apis/id4i-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/id4i/id4i-api/versions/b5f585ff1a29/schema)