POST
/
v1
/
deployments
/
extract
/
{project_id}
/
{iteration_id}
from retab import Retab

client = Retab()

completion = client.deployments.extract(
    project_id="proj_F0FE8DFqyouQdZXDTWRg0",
    iteration_id="iter_F0FE8DFqyouQdZXDTWRg0",
    document="invoice.jpeg"
)

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1744316542,
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "{\"invoice_number\": \"INV-42\", \"total_amount\": 123.45}",
        "parsed": {
          "invoice_number": "INV-42", 
          "total_amount": 123.45
        }
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1250,
    "completion_tokens": 35,
    "total_tokens": 1285
  },
  "likelihoods": {
    "invoice_number": 0.95,
    "total_amount": 0.87
  },
  "extraction_id": "ext_1234567890"
}
from retab import Retab

client = Retab()

completion = client.deployments.extract(
    project_id="proj_F0FE8DFqyouQdZXDTWRg0",
    iteration_id="iter_F0FE8DFqyouQdZXDTWRg0",
    document="invoice.jpeg"
)

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1744316542,
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "{\"invoice_number\": \"INV-42\", \"total_amount\": 123.45}",
        "parsed": {
          "invoice_number": "INV-42", 
          "total_amount": 123.45
        }
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1250,
    "completion_tokens": 35,
    "total_tokens": 1285
  },
  "likelihoods": {
    "invoice_number": 0.95,
    "total_amount": 0.87
  },
  "extraction_id": "ext_1234567890"
}

Authorizations

Api-Key
string
header
required

Headers

Idempotency-Key
string | null

Path Parameters

project_id
string
required
iteration_id
string
required

Body

multipart/form-data

Response

200
application/json

Successful Response

The response is of type object.