Skip to main content
GET
/
v2
/
documents
/
public
/
{id}
curl --request GET \
  --url 'https://api-prod.usefini.com/v2/documents/public/5d9f67a8-d853-4af4-b7ce-23ebba1245e5' \
  --header 'Authorization: Bearer fini_your_api_key'

{
  "id": "5d9f67a8-d853-4af4-b7ce-23ebba1245e5",
  "originalUrl": "https://www.notion.so/fini/Billing-FAQ-123456",
  "title": "Billing FAQ",
  "storageUrl": "gs://example/documents/5d9f67a8-d853-4af4-b7ce-23ebba1245e5",
  "source": "notion",
  "externalId": "123456",
  "english": true,
  "baser": false,
  "paragraphs": [
    "You can update your billing email from Settings."
  ],
  "oldParagraphs": [],
  "success": true,
  "error": "",
  "createdAt": "2026-05-22T06:05:34.221Z",
  "updatedAt": "2026-05-22T06:10:58.710Z",
  "mimeType": "text/markdown",
  "type": "page",
  "linkedJobId": "9f347ddb-1f90-43a2-ac9f-4f77f37a2c26",
  "linkedKnowledgeId": "8a4bb11a-0ef2-45df-9956-631e41e6cf16",
  "linkedOperation": "UPDATE_ARTICLE",
  "linkedReason": null,
  "linkedJobStatus": "COMPLETED",
  "changed": false
}
Returns one source record by ID. The response shape is identical to a single entry in List sources — same fields, same semantics. Use this endpoint when you have a source ID and want a focused payload, especially for polling linkedJobStatus during ingestion.
For the end-to-end flow, see Sources. For polling guidance, see Ingest sources.
The route path and response object still use document naming because that is the current API contract. This page uses source terminology for the product model.

​
Headers

​
Authorization
string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_...

​
Path parameters

​
id
string
required
Source ID. Get this from List sources or from the response of Ingest sources and Register provider resources.
curl --request GET \
  --url 'https://api-prod.usefini.com/v2/documents/public/5d9f67a8-d853-4af4-b7ce-23ebba1245e5' \
  --header 'Authorization: Bearer fini_your_api_key'

​
Response

The response is a single Document object. See List sources → Document for the full field reference. In the product model, this object represents one source record. 
{
  "id": "5d9f67a8-d853-4af4-b7ce-23ebba1245e5",
  "originalUrl": "https://www.notion.so/fini/Billing-FAQ-123456",
  "title": "Billing FAQ",
  "storageUrl": "gs://example/documents/5d9f67a8-d853-4af4-b7ce-23ebba1245e5",
  "source": "notion",
  "externalId": "123456",
  "english": true,
  "baser": false,
  "paragraphs": [
    "You can update your billing email from Settings."
  ],
  "oldParagraphs": [],
  "success": true,
  "error": "",
  "createdAt": "2026-05-22T06:05:34.221Z",
  "updatedAt": "2026-05-22T06:10:58.710Z",
  "mimeType": "text/markdown",
  "type": "page",
  "linkedJobId": "9f347ddb-1f90-43a2-ac9f-4f77f37a2c26",
  "linkedKnowledgeId": "8a4bb11a-0ef2-45df-9956-631e41e6cf16",
  "linkedOperation": "UPDATE_ARTICLE",
  "linkedReason": null,
  "linkedJobStatus": "COMPLETED",
  "changed": false
}

​
Errors

The id path parameter is not a valid UUID.
The API key is missing, malformed, revoked, or invalid. Confirm Authorization: Bearer fini_... with the full key.
The API key doesn’t include the read scope, or the source belongs to a different workspace than the key.
No source exists with that ID in the workspace tied to the key. Confirm the ID and that you’re authenticating against the right workspace.