Task
Get Task
Task
Get Task
Retrieves detailed information about a task by its ID, including:
- Processing status
- Task configuration
- Output data (if processing is complete)
- File metadata (name, page count)
- Timestamps (created, started, finished)
- Presigned URLs for accessing files
This endpoint can be used to:
- Poll the task status during processing
- Retrieve the final output once processing is complete
- Access task metadata and configuration
GET
/
api
/
v1
/
task
/
{task_id}
curl --request GET \
--url https://api.chunkr.ai/api/v1/task/{task_id} \
--header 'Authorization: <api-key>'
{
"configuration": {
"json_schema": {
"properties": [
{
"default": "<string>",
"description": "<string>",
"name": "<string>",
"title": "<string>",
"type": "<string>"
}
],
"title": "<string>",
"type": "<string>"
},
"model": "Fast",
"ocr_strategy": "Auto",
"segmentation_strategy": "LayoutAnalysis",
"target_chunk_length": 123
},
"created_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"file_name": "<string>",
"finished_at": "2023-11-07T05:31:56Z",
"input_file_url": "<string>",
"message": "<string>",
"output": {
"chunks": [
{
"chunk_length": 123,
"segments": [
{
"bbox": {
"height": 123,
"left": 123,
"top": 123,
"width": 123
},
"content": "<string>",
"html": "<string>",
"image": "<string>",
"markdown": "<string>",
"ocr": [
{
"bbox": {
"height": 123,
"left": 123,
"top": 123,
"width": 123
},
"confidence": 123,
"text": "<string>"
}
],
"page_height": 123,
"page_number": 1,
"page_width": 123,
"segment_id": "<string>",
"segment_type": "Title"
}
]
}
],
"extracted_json": {
"extracted_fields": [
{
"field_type": "<string>",
"name": "<string>",
"value": "<any>"
}
],
"schema_type": "<string>",
"title": "<string>"
}
},
"page_count": 123,
"pdf_url": "<string>",
"status": "Starting",
"task_id": "<string>",
"task_url": "<string>"
}
Authorizations
Path Parameters
Id of the task to retrieve
Response
200
application/json
Detailed information describing the task
Available options:
Fast
, HighQuality
Available options:
Auto
, All
, Off
Available options:
LayoutAnalysis
, Page
Available options:
Starting
, Processing
, Succeeded
, Failed
, Canceled
Required range:
x > 0
Available options:
Title
, Section header
, Text
, List item
, Table
, Picture
, Caption
, Formula
, Footnote
, Page header
, Page footer
, Page
curl --request GET \
--url https://api.chunkr.ai/api/v1/task/{task_id} \
--header 'Authorization: <api-key>'
{
"configuration": {
"json_schema": {
"properties": [
{
"default": "<string>",
"description": "<string>",
"name": "<string>",
"title": "<string>",
"type": "<string>"
}
],
"title": "<string>",
"type": "<string>"
},
"model": "Fast",
"ocr_strategy": "Auto",
"segmentation_strategy": "LayoutAnalysis",
"target_chunk_length": 123
},
"created_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"file_name": "<string>",
"finished_at": "2023-11-07T05:31:56Z",
"input_file_url": "<string>",
"message": "<string>",
"output": {
"chunks": [
{
"chunk_length": 123,
"segments": [
{
"bbox": {
"height": 123,
"left": 123,
"top": 123,
"width": 123
},
"content": "<string>",
"html": "<string>",
"image": "<string>",
"markdown": "<string>",
"ocr": [
{
"bbox": {
"height": 123,
"left": 123,
"top": 123,
"width": 123
},
"confidence": 123,
"text": "<string>"
}
],
"page_height": 123,
"page_number": 1,
"page_width": 123,
"segment_id": "<string>",
"segment_type": "Title"
}
]
}
],
"extracted_json": {
"extracted_fields": [
{
"field_type": "<string>",
"name": "<string>",
"value": "<any>"
}
],
"schema_type": "<string>",
"title": "<string>"
}
},
"page_count": 123,
"pdf_url": "<string>",
"status": "Starting",
"task_id": "<string>",
"task_url": "<string>"
}