List documents - Conduit API

GET

documents

List documents

curl --request GET \
  --url https://api.conduit.financial/v2/documents \
  --header 'x-api-key: <api-key>'

{
  "data": [
    {
      "id": "<string>",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "fileName": "passport-scan.pdf",
      "mimeType": "application/pdf",
      "name": "John Doe Passport",
      "classifiedTypes": [],
      "fileSize": 0
    }
  ],
  "meta": {
    "mode": "cursor",
    "nextCursor": "eyJpZCI6ImN1c18yeFBxTjhSIn0",
    "previousCursor": null,
    "total": 42
  }
}

Authorizations

x-api-key

string

header

required

Query Parameters

cursor

string

Opaque cursor from a previous response to fetch the next page

limit

number

default:20

Maximum number of results to return (1-100)

Required range: 1 <= x <= 100

direction

enum<string>

Pagination direction relative to the cursor

Available options:

forward,

backward

purpose

enum<string>

Filter documents by their declared purpose.

Available options:

organization_onboarding,

kyc,

feature_request,

transaction_support

Response

data

object[]

required

Show child attributes

meta

object

required

Show child attributes

Upload a documentUploads a file and creates a document record. The AI classifier determines the canonical document type at review time; the integrator does not declare it. Optional multipart fields: `purpose` and `name` (human-readable label). Maximum file size is 10 MB; the request may contain at most 16 multipart fields in total. File type is determined by inspecting the file's contents — the `Content-Type` header and filename extension are advisory only.

⌘I

List documents

curl --request GET \
  --url https://api.conduit.financial/v2/documents \
  --header 'x-api-key: <api-key>'

{
  "data": [
    {
      "id": "<string>",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "fileName": "passport-scan.pdf",
      "mimeType": "application/pdf",
      "name": "John Doe Passport",
      "classifiedTypes": [],
      "fileSize": 0
    }
  ],
  "meta": {
    "mode": "cursor",
    "nextCursor": "eyJpZCI6ImN1c18yeFBxTjhSIn0",
    "previousCursor": null,
    "total": 42
  }
}