---
title: "List Merchant Documents"
method: GET
path: "/merchants/{merchant_id}/documents"
tags: ["Merchants"]
---

# List Merchant Documents

`GET /merchants/{merchant_id}/documents`

## Request

- Base URL: `https://app-sandbox.resolvepay.com/api`
- URL: `https://app-sandbox.resolvepay.com/api/merchants/{merchant_id}/documents`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
- TypeScript: <https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/docs/merchants/:merchant_id/documents/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns document presence and validation lifecycle status for a specific sub-merchant.

This endpoint is metadata-only and does not return file bodies or signed retrieval URLs.

Supported query options:
- Pagination: `limit`, `page`
- Sorting: `sort`
- Field filters: `filter[field][eq]=value`

Supported filter fields:
- `document_type`
- `status`

Supported sort fields:
- `created_at`

Use `-` prefix for descending sort, for example `sort=-created_at`.

## Path parameters

- `merchant_id` string, required

## Query parameters

- `limit` integer
- `page` integer
- `sort` 'created_at' | '-created_at'
- `filter` object
  - `document_type` object
    - `eq` string
  - `status` object
    - `eq` 'pending_upload' | 'uploaded_pending_validation' | 'accepted' | 'rejected' | 'failed'

## Response `200`

Paginated list of merchant document metadata.

- MerchantDocumentList
  - `count` integer
  - `page` integer
  - `limit` integer
  - `results` MerchantDocument[]
    - `id` string
    - `merchant_id` string
    - `document_type` 'bank_statements' | 'financial_statements' | 'credit_references' | 'personal_guarantee' | 'other'
    - `status` 'pending_upload' | 'uploaded_pending_validation' | 'accepted' | 'rejected' | 'failed': Current validation lifecycle status.
    - `validation_reasons` string[]: Validation reason codes/messages associated with the current status.
    - `uploaded_at` string, date-time, nullable
    - `validated_at` string, date-time, nullable
    - `object_key` string, nullable: S3 object key reference used by validation/reconciliation flows.
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `400`: Bad request error
- `401`: Unauthorized error
- `404`: Not found error
- `429`: Rate limit error

---

[API](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference.md) - [All operations](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/revisions/5a1c75b8b404?raw)