Prebuilt information extraction

Deprecation notice

Prebuilt Information Extraction was deprecated on May 6, 2026. Please use Universal extraction instead.

What is prebuilt information extraction?

Built on highly accurate Document OCR, Upstage's prebuilt information extraction models excel at identifying and extracting predefined key information within specific documents types. Prebuilt information extractors are ideal for automating repetitive tasks--such as data entry, compliance checks, or invoice processing, where specific fields must be extracted consistently and accurately with large throughput.

Why use Upstage prebuilt information extractors?

Tailored for specific document types: Unlike universal information extraction models, Upstage prebuilt information extractors are fine-tuned for specific document formats, achieving higher accuracy, typically around 90-95% for tens to hundreds of keys. This level of precision makes them ideal for processing documents with monetary values, such as invoices, receipts, contracts, forms, and financial reports, where capturing accurate information is essential for automating processes.
High robustness for documents in the wild: Our prebuilt information extractors handle challenging document conditions, including rotated images, watermarks, noise, and checkboxes, ensuring reliable performance even with imperfect or low-quality inputs.
Seamless integration: Designed for enterprise applications, our extractors provide structured outputs in JSON format, making it easy to integrate into existing automation pipelines, databases, and business workflows.

What models does Upstage provide?

Receipt

Sample document	General receipt
Alias	receipt-extraction
Currently points to	receipt-extraction-3.2.0
RPS (Learn more)	1

Logistics documents

Sample document	Air waybill	Bill of lading	Shipping request
Alias	air-waybill-extraction	bill-of-lading-and-shipping-request-extraction	bill-of-lading-and-shipping-request-extraction
Currently points to	air-waybill-extraction-250415	bill-of-lading-and-shipping-request-extraction-250415	bill-of-lading-and-shipping-request-extraction-250415
RPS (Learn more)	1	1	1
Sample document	Commercial invoice	Packing list	수출신고필증
Alias	commercial-invoice-and-packing-list-extraction	commercial-invoice-and-packing-list-extraction	kr-export-declaration-certificate-extraction
Currently points to	commercial-invoice-and-packing-list-extraction-250415	commercial-invoice-and-packing-list-extraction-250415	kr-export-declaration-certificate-extraction-250415
RPS (Learn more)	1	1	1

Don’t see your document type listed?

Contact us—we provide access to hundreds of private models for a wide range of document types, and offer high-precision custom model development to meet your specific business needs.

Extract Key Information in Upstage Studio!

Identify and structure critical data from unstructured documents — ideal for automation beyond basic parsing.

Ready to build?

✓ Get $10 on signup

✓ Create your API key instantly

✓ Quick test with example codes

Input requirements

Supported file formats: JPEG, PNG, BMP, PDF, TIFF, HEIC, DOCX, PPTX, XLSX, HWP, HWPX
Maximum file size: 50MB
Maximum number of pages per file: 30 pages (For files exceeding 30 pages, the first 30 pages are processed)
Maximum pixels per page: 100,000,000 pixels. For non-image files, the pixel count is determined after converting to images at a standard of 150 DPI.
Supported character sets: Alphanumeric, Hangul, and Hanja are supported. Hanzi and Kanji are in beta versions, indicating that they are available but not fully supported.

Hanja, Hanzi, and Kanji are writing systems based on Chinese characters used in Korean, Chinese, and Japanese writing systems. Despite sharing similarities, they possess distinct visual representations, pronunciations, meanings, and usage conventions within their respective linguistic contexts. For more information, see this article.

Example

Request

# pip install requests

import requests

api_key = "UPSTAGE_API_KEY"  # ex: up_xxxYYYzzzAAAbbbCCC
filename = "YOUR_FILE_NAME"         # ex: ./image.png
model = "MODEL_NAME"                # ex: receipt-extraction

url = f"https://api.upstage.ai/v1/information-extraction"
headers = {"Authorization": f"Bearer {api_key}"}

files = {"document": open(filename, "rb")}
data = {"model": model}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

Response

{
  "apiVersion": "1.1",
  "confidence": 0.8693423350242669,
  "documentType": "receipt",
  "fields": [
    {
      "id": 0,
      "key": "group_0",
      "properties": [
        {
          "confidence": 0.9924821257591248,
          "id": 1,
          "key": "group_0/menu.unit_product_quantity",
          "refinedValue": "3",
          "type": "content",
          "value": "3"
        },
        {
          "confidence": 0.9585183839652158,
          "id": 2,
          "key": "group_0/menu.product_name",
          "refinedValue": "Classic Mojito",
          "type": "content",
          "value": "Classic Mojito"
        },
        {
          "confidence": 0.9199805958380287,
          "id": 3,
          "key": "group_0/menu.unit_product_total_price_before_discount",
          "refinedValue": "45.00",
          "type": "content",
          "value": "$45 00"
        }
      ],
      "refinedValue": "",
      "type": "group",
      "value": "3 Classic Mojito $45 00"
    },
    {
      "id": 4,
      "key": "group_0",
      "properties": [
        {
          "confidence": 0.9604779481887817,
          "id": 5,
          "key": "group_0/menu.unit_product_quantity",
          "refinedValue": "1",
          "type": "content",
          "value": "1"
        },
        {
          "confidence": 0.9843973246343797,
          "id": 6,
          "key": "group_0/menu.product_name",
          "refinedValue": "Margarita Classic",
          "type": "content",
          "value": "Margarita Classic"
        },
        {
          "confidence": 0.9064315192491437,
          "id": 7,
          "key": "group_0/menu.unit_product_total_price_before_discount",
          "refinedValue": "15.00",
          "type": "content",
          "value": "$15 00"
        }
      ],
      "refinedValue": "",
      "type": "group",
      "value": "1 Margarita Classic $15 00"
    },
    {
      "id": 8,
      "key": "group_0",
      "properties": [
        {
          "confidence": 0.9691067934036255,
          "id": 9,
          "key": "group_0/menu.unit_product_quantity",
          "refinedValue": "1",
          "type": "content",
          "value": "1"
        },
        {
          "confidence": 0.5245915964832683,
          "id": 10,
          "key": "group_0/menu.product_name",
          "refinedValue": "Parrillada Yuca con Mcjo Yuca Fritas Medium",
          "type": "content",
          "value": "Parrillada Yuca con Mcjo Yuca Fritas Medium"
        },
        {
          "confidence": 0.9572980538130436,
          "id": 11,
          "key": "group_0/menu.unit_product_total_price_before_discount",
          "refinedValue": "90.00",
          "type": "content",
          "value": "$90 00"
        }
      ],
      "refinedValue": "",
      "type": "group",
      "value": "1 Parrillada Yuca con Mcjo Yuca Fritas Medium $90 00"
    },
    {
      "id": 12,
      "key": "group_0",
      "properties": [
        {
          "confidence": 0.9693443179130554,
          "id": 13,
          "key": "group_0/menu.unit_product_quantity",
          "refinedValue": "1",
          "type": "content",
          "value": "1"
        },
        {
          "confidence": 0.8845985036390739,
          "id": 14,
          "key": "group_0/menu.product_name",
          "refinedValue": "Hemingway S Ma lecon",
          "type": "content",
          "value": "Hemingway S Ma lecon"
        },
        {
          "confidence": 0.8875203900519126,
          "id": 15,
          "key": "group_0/menu.unit_product_total_price_before_discount",
          "refinedValue": "15.00",
          "type": "content",
          "value": "$15.00"
        }
      ],
      "refinedValue": "",
      "type": "group",
      "value": "1 Hemingway S Ma lecon $15.00"
    },
    {
      "id": 16,
      "key": "group_0",
      "properties": [
        {
          "confidence": 0.977379322052002,
          "id": 17,
          "key": "group_0/menu.unit_product_quantity",
          "refinedValue": "1",
          "type": "content",
          "value": "1"
        },
        {
          "confidence": 0.9403543115198569,
          "id": 18,
          "key": "group_0/menu.product_name",
          "refinedValue": "Strawberry Moj ito",
          "type": "content",
          "value": "Strawberry Moj ito"
        },
        {
          "confidence": 0.9263305215507435,
          "id": 19,
          "key": "group_0/menu.unit_product_total_price_before_discount",
          "refinedValue": "15.00",
          "type": "content",
          "value": "$15 00"
        }
      ],
      "refinedValue": "",
      "type": "group",
      "value": "1 Strawberry Moj ito $15 00"
    },
    {
      "confidence": 0.9819169006082817,
      "id": 20,
      "key": "store.store_name",
      "refinedValue": "HAVANA VIEJA",
      "type": "content",
      "value": "HAVANA VIEJA"
    },
    {
      "confidence": 0.6618761453146255,
      "id": 21,
      "key": "store.store_address",
      "refinedValue": "944 Washington Ave Miami Beach F1. 33139",
      "type": "content",
      "value": "944 Washington Ave Miami Beach F1. 33139"
    },
    {
      "confidence": 0.9922102908265871,
      "id": 22,
      "key": "total.subtotal_price",
      "refinedValue": "Subtotal",
      "type": "header",
      "value": "Subtotal"
    },
    {
      "confidence": 0.7275943936665118,
      "id": 23,
      "key": "total.subtotal_price",
      "refinedValue": "180.00",
      "type": "content",
      "value": "$180 .00"
    },
    {
      "confidence": 0.2429200998999827,
      "id": 24,
      "key": "total.tip_price",
      "refinedValue": "Gratuity (20 00%",
      "type": "header",
      "value": "Gratuity (20 00%"
    },
    {
      "confidence": 0.8521402045045384,
      "id": 25,
      "key": "total.tip_price",
      "refinedValue": "36.00",
      "type": "content",
      "value": "$36.00"
    },
    {
      "confidence": 0.8664104635738139,
      "id": 26,
      "key": "total.tax_price",
      "refinedValue": "16.20",
      "type": "content",
      "value": "$16 .20"
    },
    {
      "confidence": 0.8695934498569926,
      "id": 27,
      "key": "total.tax_price",
      "refinedValue": "Tax",
      "type": "header",
      "value": "Tax"
    },
    {
      "confidence": 0.9746453544850778,
      "id": 28,
      "key": "total.charged_price",
      "refinedValue": "Total",
      "type": "header",
      "value": "Total"
    },
    {
      "confidence": 0.9548797788891511,
      "id": 29,
      "key": "total.charged_price",
      "refinedValue": "232.20",
      "type": "content",
      "value": "$232.20"
    }
  ],
  "metadata": {
    "pages": [
      {
        "height": 4032,
        "page": 1,
        "width": 3024
      }
    ]
  },
  "mimeType": "multipart/form-data",
  "modelVersion": "receipt-extraction-3.2.0",
  "numBilledPages": 1,
  "stored": true
}

Extract Key Information in Upstage Studio!

Identify and structure critical data from unstructured documents — ideal for automation beyond basic parsing.

Ready to build?

✓ Get $10 on signup

✓ Create your API key instantly

✓ Quick test with example codes

Frequently Asked Questions

Check out frequently asked questions below. For more FAQs, visit the FAQ page.

Prebuilt information extraction

Deprecation notice

Prebuilt Information Extraction was deprecated on May 6, 2026. Please use Universal extraction instead.

What is prebuilt information extraction?

Why use Upstage prebuilt information extractors?

Tailored for specific document types: Unlike universal information extraction models, Upstage prebuilt information extractors are fine-tuned for specific document formats, achieving higher accuracy, typically around 90-95% for tens to hundreds of keys. This level of precision makes them ideal for processing documents with monetary values, such as invoices, receipts, contracts, forms, and financial reports, where capturing accurate information is essential for automating processes.
High robustness for documents in the wild: Our prebuilt information extractors handle challenging document conditions, including rotated images, watermarks, noise, and checkboxes, ensuring reliable performance even with imperfect or low-quality inputs.
Seamless integration: Designed for enterprise applications, our extractors provide structured outputs in JSON format, making it easy to integrate into existing automation pipelines, databases, and business workflows.

What models does Upstage provide?

Receipt

Sample document	General receipt
Alias	receipt-extraction
Currently points to	receipt-extraction-3.2.0
RPS (Learn more)	1

Logistics documents

Sample document	Air waybill	Bill of lading	Shipping request
Alias	air-waybill-extraction	bill-of-lading-and-shipping-request-extraction	bill-of-lading-and-shipping-request-extraction
Currently points to	air-waybill-extraction-250415	bill-of-lading-and-shipping-request-extraction-250415	bill-of-lading-and-shipping-request-extraction-250415
RPS (Learn more)	1	1	1
Sample document	Commercial invoice	Packing list	수출신고필증
Alias	commercial-invoice-and-packing-list-extraction	commercial-invoice-and-packing-list-extraction	kr-export-declaration-certificate-extraction
Currently points to	commercial-invoice-and-packing-list-extraction-250415	commercial-invoice-and-packing-list-extraction-250415	kr-export-declaration-certificate-extraction-250415
RPS (Learn more)	1	1	1

Don’t see your document type listed?

Contact us—we provide access to hundreds of private models for a wide range of document types, and offer high-precision custom model development to meet your specific business needs.

Extract Key Information in Upstage Studio!

Identify and structure critical data from unstructured documents — ideal for automation beyond basic parsing.

Ready to build?

✓ Get $10 on signup

✓ Create your API key instantly

✓ Quick test with example codes

Input requirements

Supported file formats: JPEG, PNG, BMP, PDF, TIFF, HEIC, DOCX, PPTX, XLSX, HWP, HWPX
Maximum file size: 50MB
Maximum number of pages per file: 30 pages (For files exceeding 30 pages, the first 30 pages are processed)
Maximum pixels per page: 100,000,000 pixels. For non-image files, the pixel count is determined after converting to images at a standard of 150 DPI.
Supported character sets: Alphanumeric, Hangul, and Hanja are supported. Hanzi and Kanji are in beta versions, indicating that they are available but not fully supported.

Example

Request

# pip install requests

import requests

api_key = "UPSTAGE_API_KEY"  # ex: up_xxxYYYzzzAAAbbbCCC
filename = "YOUR_FILE_NAME"         # ex: ./image.png
model = "MODEL_NAME"                # ex: receipt-extraction

url = f"https://api.upstage.ai/v1/information-extraction"
headers = {"Authorization": f"Bearer {api_key}"}

files = {"document": open(filename, "rb")}
data = {"model": model}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

Response

{
  "apiVersion": "1.1",
  "confidence": 0.8693423350242669,
  "documentType": "receipt",
  "fields": [
    {
      "id": 0,
      "key": "group_0",
      "properties": [
        {
          "confidence": 0.9924821257591248,
          "id": 1,
          "key": "group_0/menu.unit_product_quantity",
          "refinedValue": "3",
          "type": "content",
          "value": "3"
        },
        {
          "confidence": 0.9585183839652158,
          "id": 2,
          "key": "group_0/menu.product_name",
          "refinedValue": "Classic Mojito",
          "type": "content",
          "value": "Classic Mojito"
        },
        {
          "confidence": 0.9199805958380287,
          "id": 3,
          "key": "group_0/menu.unit_product_total_price_before_discount",
          "refinedValue": "45.00",
          "type": "content",
          "value": "$45 00"
        }
      ],
      "refinedValue": "",
      "type": "group",
      "value": "3 Classic Mojito $45 00"
    },
    {
      "id": 4,
      "key": "group_0",
      "properties": [
        {
          "confidence": 0.9604779481887817,
          "id": 5,
          "key": "group_0/menu.unit_product_quantity",
          "refinedValue": "1",
          "type": "content",
          "value": "1"
        },
        {
          "confidence": 0.9843973246343797,
          "id": 6,
          "key": "group_0/menu.product_name",
          "refinedValue": "Margarita Classic",
          "type": "content",
          "value": "Margarita Classic"
        },
        {
          "confidence": 0.9064315192491437,
          "id": 7,
          "key": "group_0/menu.unit_product_total_price_before_discount",
          "refinedValue": "15.00",
          "type": "content",
          "value": "$15 00"
        }
      ],
      "refinedValue": "",
      "type": "group",
      "value": "1 Margarita Classic $15 00"
    },
    {
      "id": 8,
      "key": "group_0",
      "properties": [
        {
          "confidence": 0.9691067934036255,
          "id": 9,
          "key": "group_0/menu.unit_product_quantity",
          "refinedValue": "1",
          "type": "content",
          "value": "1"
        },
        {
          "confidence": 0.5245915964832683,
          "id": 10,
          "key": "group_0/menu.product_name",
          "refinedValue": "Parrillada Yuca con Mcjo Yuca Fritas Medium",
          "type": "content",
          "value": "Parrillada Yuca con Mcjo Yuca Fritas Medium"
        },
        {
          "confidence": 0.9572980538130436,
          "id": 11,
          "key": "group_0/menu.unit_product_total_price_before_discount",
          "refinedValue": "90.00",
          "type": "content",
          "value": "$90 00"
        }
      ],
      "refinedValue": "",
      "type": "group",
      "value": "1 Parrillada Yuca con Mcjo Yuca Fritas Medium $90 00"
    },
    {
      "id": 12,
      "key": "group_0",
      "properties": [
        {
          "confidence": 0.9693443179130554,
          "id": 13,
          "key": "group_0/menu.unit_product_quantity",
          "refinedValue": "1",
          "type": "content",
          "value": "1"
        },
        {
          "confidence": 0.8845985036390739,
          "id": 14,
          "key": "group_0/menu.product_name",
          "refinedValue": "Hemingway S Ma lecon",
          "type": "content",
          "value": "Hemingway S Ma lecon"
        },
        {
          "confidence": 0.8875203900519126,
          "id": 15,
          "key": "group_0/menu.unit_product_total_price_before_discount",
          "refinedValue": "15.00",
          "type": "content",
          "value": "$15.00"
        }
      ],
      "refinedValue": "",
      "type": "group",
      "value": "1 Hemingway S Ma lecon $15.00"
    },
    {
      "id": 16,
      "key": "group_0",
      "properties": [
        {
          "confidence": 0.977379322052002,
          "id": 17,
          "key": "group_0/menu.unit_product_quantity",
          "refinedValue": "1",
          "type": "content",
          "value": "1"
        },
        {
          "confidence": 0.9403543115198569,
          "id": 18,
          "key": "group_0/menu.product_name",
          "refinedValue": "Strawberry Moj ito",
          "type": "content",
          "value": "Strawberry Moj ito"
        },
        {
          "confidence": 0.9263305215507435,
          "id": 19,
          "key": "group_0/menu.unit_product_total_price_before_discount",
          "refinedValue": "15.00",
          "type": "content",
          "value": "$15 00"
        }
      ],
      "refinedValue": "",
      "type": "group",
      "value": "1 Strawberry Moj ito $15 00"
    },
    {
      "confidence": 0.9819169006082817,
      "id": 20,
      "key": "store.store_name",
      "refinedValue": "HAVANA VIEJA",
      "type": "content",
      "value": "HAVANA VIEJA"
    },
    {
      "confidence": 0.6618761453146255,
      "id": 21,
      "key": "store.store_address",
      "refinedValue": "944 Washington Ave Miami Beach F1. 33139",
      "type": "content",
      "value": "944 Washington Ave Miami Beach F1. 33139"
    },
    {
      "confidence": 0.9922102908265871,
      "id": 22,
      "key": "total.subtotal_price",
      "refinedValue": "Subtotal",
      "type": "header",
      "value": "Subtotal"
    },
    {
      "confidence": 0.7275943936665118,
      "id": 23,
      "key": "total.subtotal_price",
      "refinedValue": "180.00",
      "type": "content",
      "value": "$180 .00"
    },
    {
      "confidence": 0.2429200998999827,
      "id": 24,
      "key": "total.tip_price",
      "refinedValue": "Gratuity (20 00%",
      "type": "header",
      "value": "Gratuity (20 00%"
    },
    {
      "confidence": 0.8521402045045384,
      "id": 25,
      "key": "total.tip_price",
      "refinedValue": "36.00",
      "type": "content",
      "value": "$36.00"
    },
    {
      "confidence": 0.8664104635738139,
      "id": 26,
      "key": "total.tax_price",
      "refinedValue": "16.20",
      "type": "content",
      "value": "$16 .20"
    },
    {
      "confidence": 0.8695934498569926,
      "id": 27,
      "key": "total.tax_price",
      "refinedValue": "Tax",
      "type": "header",
      "value": "Tax"
    },
    {
      "confidence": 0.9746453544850778,
      "id": 28,
      "key": "total.charged_price",
      "refinedValue": "Total",
      "type": "header",
      "value": "Total"
    },
    {
      "confidence": 0.9548797788891511,
      "id": 29,
      "key": "total.charged_price",
      "refinedValue": "232.20",
      "type": "content",
      "value": "$232.20"
    }
  ],
  "metadata": {
    "pages": [
      {
        "height": 4032,
        "page": 1,
        "width": 3024
      }
    ]
  },
  "mimeType": "multipart/form-data",
  "modelVersion": "receipt-extraction-3.2.0",
  "numBilledPages": 1,
  "stored": true
}

Extract Key Information in Upstage Studio!

Identify and structure critical data from unstructured documents — ideal for automation beyond basic parsing.

Ready to build?

✓ Get $10 on signup

✓ Create your API key instantly

✓ Quick test with example codes

Frequently Asked Questions

Check out frequently asked questions below. For more FAQs, visit the FAQ page.

Prebuilt information extraction

What is prebuilt information extraction?

Why use Upstage prebuilt information extractors?

What models does Upstage provide?

Receipt

Logistics documents

Input requirements

Example

Request

Response

Frequently Asked Questions

On this page

Prebuilt information extraction

What is prebuilt information extraction?

Why use Upstage prebuilt information extractors?

What models does Upstage provide?

Receipt

Logistics documents

Input requirements

Example

Request

Response

Frequently Asked Questions

On this page

Q. Can I request multiple documents at once?

Q. Is there an interface for filtering specific fields in the Prebuilt information extraction API response?

Q. Why am I getting '415 Unsupported Media Type' error during an API Request?

Q. Why is the response time slow or delayed?

Q. How can I increase the rate limit, and are there any conditions required?

Q. Why am I getting '429 Too Many Requests' error during an API request (rate limit)?

On this page

Q. Can I request multiple documents at once?

Q. Is there an interface for filtering specific fields in the Prebuilt information extraction API response?

Q. Why am I getting '415 Unsupported Media Type' error during an API Request?

Q. Why is the response time slow or delayed?

Q. How can I increase the rate limit, and are there any conditions required?

Q. Why am I getting '429 Too Many Requests' error during an API request (rate limit)?

On this page