List Inputs

List all document ingestion sources in your workspace with GET /v1/sources. Each source carries its own API key and upload endpoint for ingestion.

The GET /v1/sources endpoint lists every document ingestion source in your Talonic workspace. A source groups documents by origin, such as an invoice feed or a contract inbox, and each source carries its own scoped API key and a dedicated endpoint URL for programmatic document uploads.

Sources are the entry point for document ingestion in Talonic. Each source represents a distinct document stream or integration — for example, an invoice intake or a contract review workflow. Documents ingested through a source inherit its configuration, including any default schema.

Each source has a unique endpoint URL for document ingestion. Use the source-scoped API key (returned at creation) to authenticate uploads to that endpoint.

GET/v1/sources

Request

Response

Response fields

dataarrayArray of source objects.

data[].idstringSource UUID.

data[].namestringHuman-readable name.

data[].typestringSource type (e.g. `api`).

data[].statusstringCurrent status: `active`, `syncing`, or `error`.

data[].document_countintegerNumber of documents ingested through this source.

data[].default_schemaobject | nullDefault schema for this source, or null if none is set. Contains `id`.

data[].endpointstringURL to POST documents to this source.

data[].created_atstringISO 8601 creation timestamp.

data[].linksobjectRelated resource URLs (self, documents, dashboard).

Response

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Invoice Pipeline",
      "type": "api",
      "status": "active",
      "document_count": 234,
      "default_schema": null,
      "endpoint": "/v1/sources/a1b2c3d4-e5f6-7890-abcd-ef1234567890/documents",
      "created_at": "2024-08-01T09:00:00.000Z",
      "links": {
        "self": "/v1/sources/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "documents": "/v1/sources/a1b2c3d4-e5f6-7890-abcd-ef1234567890/documents",
        "dashboard": "https://app.talonic.com/sources/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      }
    }
  ]
}

Errors

Error responses

401unauthorizedMissing or invalid API key.

429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Create Input

Get Source

Source Documents