---
title: "List Resource Documents"
method: GET
path: "/v1/resources/resource/{resource_id}/documents"
tags: ["API / Resource", "Use case / Master data sync"]
---

# List Resource Documents

`GET /v1/resources/resource/{resource_id}/documents`

## Request

- Base URL: `https://api.qargo.com`
- URL: `https://api.qargo.com/v1/resources/resource/{resource_id}/documents`
- Auth: OAuth 2 (client credentials, token URL `/v1/auth/token`)

List the documents of a resource that are not attached to a validity. Documents attached to a validity are listed through the validity documents endpoint. Returns an empty list when the resource has no such documents.

## Path parameters

- `resource_id` string, uuid, required

## Response `200`

Successful Response

- Document[]
  - `id` string, uuid, required: Unique identifier of the document
  - `name` string, required: Name of the document
  - `type` string, required: Type of the document
  - `download_url` string: Relative URL from the base URL to download the document
  - `subject_type` string, required: Linked subject of the document
  - `content_type` string, nullable: Content type of the document

## Other responses

- `400`: Bad Request — invalid input or malformed request
- `401`: Unauthorized — missing or invalid authentication credentials
- `403`: Forbidden — insufficient permissions for this operation
- `422`: Validation Error
- `429`: Too Many Requests — rate limit exceeded. See the `Retry-After` header
- `500`: Internal Server Error
- `503`: Service Unavailable — temporarily unable to handle the request

## Changes

- **2026-10-06** `1f913023231c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qargo/apis/qargo-tms-api/changes/v1/resources/resource/:resource_id/documents/get.md)

---

[API](https://skmtc.dev/qargo/apis/qargo-tms-api.md) · [All operations](https://skmtc.dev/qargo/apis/qargo-tms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qargo/apis/qargo-tms-api/revisions/46db2c329351?raw)