---
title: "Get all SubTpp documents"
method: GET
path: "/member/sub-tpps/{sub_tpp_id}/documents"
tags: ["Sub-TPPs"]
---

# Get all SubTpp documents

`GET /member/sub-tpps/{sub_tpp_id}/documents`

## Request

- Base URL: `https://api.token.io`
- URL: `https://api.token.io/member/sub-tpps/{sub_tpp_id}/documents`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

The `GET /member/sub-tpps/{sub_tpp_id}/documents` endpoint retrieves all documents for a SubTpp with optional filtering by status.

## Path parameters

- `sub_tpp_id` string, required

## Query parameters

- `statuses` string[]

## Response `200`

Successful response

- GetDocumentsResponse
  - `documents` Document[]
    - `id` string
    - `member_id` string
    - `sub_tpp_id` string
    - `document_name` string
    - `description` string
    - `file_id` string
    - `status` 'PENDING_UPLOAD' | 'UPLOADED' | 'WITHDRAWN'
    - `upload_optional` boolean
    - `created_at_ms` integer
    - `updated_at_ms` integer

## Other responses

- `400`: The client specified an invalid argument
- `401`: The authorization information is missing or invalid
- `403`: Permission to access this endpoint is denied
- `404`: The requested entity, such as a sub-tpp, was not found
- `429`: Too many requests
- `500`: An unexpected or internal server error
- `501`: The operation was not implemented
- `503`: Service is unavailable
- `504`: Gateway has timed out

---

[API](https://skmtc.dev/token/apis/token-io-s-open-banking-api-for-tpps.md) - [All operations](https://skmtc.dev/token/apis/token-io-s-open-banking-api-for-tpps/llms.txt) - [OpenAPI document](https://skmtc.dev/token/apis/token-io-s-open-banking-api-for-tpps/revisions/f705d3537678?raw)
