Skip to main content
POST
/
api
/
v1
/
extract
/
async
Asynchronous Extraction
curl --request POST \
  --url https://extraction-api.nanonets.com/api/v1/extract/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form output_format=markdown \
  --form file='@example-file'
{
  "success": true,
  "message": "<string>",
  "record_id": "<string>",
  "status": "completed",
  "result": {
    "markdown": {
      "content": "<string>",
      "metadata": {
        "bounding_boxes": {},
        "confidence_score": {}
      }
    },
    "html": {
      "content": "<string>",
      "metadata": {
        "bounding_boxes": {},
        "confidence_score": {}
      }
    },
    "json": {
      "content": "<string>",
      "metadata": {
        "bounding_boxes": {},
        "confidence_score": {}
      }
    },
    "csv": {
      "content": "<string>",
      "metadata": {
        "bounding_boxes": {},
        "confidence_score": {}
      }
    }
  },
  "processing_time": 123,
  "filename": "<string>",
  "output_format": "<string>",
  "file_size": 123,
  "pages_processed": 123,
  "created_at": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docstrange.nanonets.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key as Bearer token: Authorization: Bearer YOUR_API_KEY

Body

multipart/form-data
​
output_format
string
required

Output format(s): markdown, html, json, csv. Comma-separate for multiple (e.g., markdown,json).

Example:

"markdown"

​
file
file

File to upload (PDF, Word, Excel, PowerPoint, images)

​
file_url
string<uri>

URL to download file from

Example:

""

​
file_base64
string

Base64-encoded file content

Example:

""

​
custom_instructions
string

Custom extraction instructions (e.g., Format dates as YYYY-MM-DD)

Maximum string length: 8000
Example:

""

​
prompt_mode
enum<string>
default:append

append: add to base prompt, replace: use only custom instructions

Available options:
append,
replace
​
json_options
string

JSON extraction options. Values: hierarchy_output, table-of-contents, field list ["field1", "field2"], or JSON schema {...}

Example:

""

​
csv_options
string

CSV extraction options (e.g., table)

Example:

""

​
include_metadata
string

Comma-separated metadata: bounding_boxes, confidence_score

Example:

""

​
extract_charts
enum<string>

When true, extracts data points from charts, graphs, and labeled technical diagrams as structured tables. Tables are inserted inline after each image in Markdown output.

Available options:
true,
false
Example:

""

​
agentic_mode
enum<string>

When true, runs an agentic post-processing pipeline that refines the JSON extraction. Requires output_format=json. Use agentic_steps to pick which steps to run.

Available options:
true,
false
Example:

""

​
agentic_steps
string

Comma-separated list of agentic steps to run. Requires agentic_mode=true. Available steps:

  • agentic_enhance — Reconciles conflicts that arise when same information is present at multiple places in large documents.
  • validate_json_schema — Validates the extracted JSON against your json_options schema and corrects any violations.
Example:

"agentic_enhance,validate_json_schema"

Response

Job queued

​
success
boolean
required
​
message
string
required
​
record_id
string
required

Job ID for retrieving results

​
status
enum<string>
required
Available options:
completed,
processing,
failed
​
result
object

Results by format (only requested formats populated)

​
processing_time
number

Time in seconds

​
filename
string
​
output_format
string
​
file_size
integer

Size in bytes

​
pages_processed
integer
​
created_at
string<date-time>