Skip to content
LionrapidLionRapid Docs

Get Ocr Blocks Status

GET
/ocr/blocks/{task_id}
curl --request GET \
  --url https://example.com/ocr/blocks/example \
  --header 'Authorization: Bearer <token>'

Poll the status of an OCR blocks job submitted via POST /ocr/extract_blocks.

Returns: status=pending — queued, waiting for worker status=started — worker is processing (warmup or active inference) status=completed — text_blocks is populated status=failed — error contains failure details

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
task_id
required
Task Id
string

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
OCRBlocksStatus
object
task_id
required
Task Id

Celery task ID

string
status
required
Status

Task status: pending, started, completed, failed

string
text_blocks
Any of:
Array<object>
TextBlock
object
text
required
Text

Extracted text content of the block

string
bbox
required
Bbox

Bounding box [x, y, width, height] in pixels

Array<number>
>= 4 items <= 4 items
confidence
required
Confidence

Confidence score (0–1)

number
<= 1
model_used
Any of:
string
processing_time_ms
Any of:
integer
error
Any of:
string
Examplegenerated
{
  "task_id": "example",
  "status": "example",
  "text_blocks": [
    {
      "text": "example",
      "bbox": [
        1
      ],
      "confidence": 1
    }
  ],
  "model_used": "example",
  "processing_time_ms": 1,
  "error": "example"
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}