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"
}
Returns one document record by ID. The response shape is identical to a single entry in List documents — same fields, same semantics. Use this endpoint when you have a document ID and want a focused payload, especially for polling linkedJobStatus during ingestion.
For background on async ingestion and which fields to watch while polling, see The async model.

​
Headers

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

​
Path parameters

​
id
string
required
Document ID. Get this from List documents or from the response of Queue ingestion 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 documents → Response for the full field reference — the shape is identical. 
{
  "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"
}

​
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 document belongs to a different workspace than the key.
No document exists with that ID in the workspace tied to the key. Confirm the ID and that you’re authenticating against the right workspace.