curl https://transform.unstructured.io/api/v2/parse \
-H "unstructured-api-key: $UNSTRUCTURED_API_KEY" \
-F "input=@document.pdf"
{
"id": "9eb6c914-02a5-4c5d-8490-a06476946a38",
"status": "completed",
"profile": "balanced",
"warnings": [],
"markdown": "Invoice number: INV-1001",
"format_version": "2.0",
"metadata": {
"page_count": 1
},
"extracted_data": [],
"elements": [],
"source": {
"file_id": "invoice-9eb6c914.pdf",
"filename": "invoice.pdf",
"mimetype": "application/pdf",
"expires_at": "2026-09-18T18:34:26Z"
}
}API endpoints
Parse a document
Parse a document with the Transform API. Review the input field, output and profile options, and the Markdown or elements response schema.
POST
/
api
/
v2
/
parse
curl https://transform.unstructured.io/api/v2/parse \
-H "unstructured-api-key: $UNSTRUCTURED_API_KEY" \
-F "input=@document.pdf"
{
"id": "9eb6c914-02a5-4c5d-8490-a06476946a38",
"status": "completed",
"profile": "balanced",
"warnings": [],
"markdown": "Invoice number: INV-1001",
"format_version": "2.0",
"metadata": {
"page_count": 1
},
"extracted_data": [],
"elements": [],
"source": {
"file_id": "invoice-9eb6c914.pdf",
"filename": "invoice.pdf",
"mimetype": "application/pdf",
"expires_at": "2026-09-18T18:34:26Z"
}
}Parse a document with one body field:
Start with Parse your first document.
input. Authenticate with your API key. Output defaults to Markdown; profile and other controls are optional.
curl https://transform.unstructured.io/api/v2/parse \
-H "unstructured-api-key: $UNSTRUCTURED_API_KEY" \
-F "input=@document.pdf"
Authorizations
ApiKeyAuthBearerAuth
Headers
Query Parameters
Body
multipart/form-data
A document to parse, plus an optional schema to extract from it. Either input or file_id must be provided.
Response
The parse operation result, carrying the canonical document.
Parse operation metadata plus the canonical document, possibly before extraction has finished.
Was this page helpful?

