Name: PerfectParser
Availability: InStock

`GET /v1/extractions/:extraction_id/results`

Retrieve the final structured JSON extraction results for all documents within an extraction job. If processing is still active, it returns results for the files that have finished so far.

Path Parameters

Parameter	Type	Required	Description
`extraction_id`	`string`	✅	The unique ID of the extraction job.

curl https://api.perfectparser.com/v1/extractions/ext_123/results \
  -H "X-API-Key: pp_live_your_secret_key"

Response 200 OK

{
  "extraction": {
    "extraction_id": "ext_123",
    "parser_id": "prs_999",
    "status": "completed",
    "file_count": 1,
    "page_count": 3,
    "credits_used": 3,
    "created_at": "2026-06-20T10:00:00.000Z",
    "completed_at": "2026-06-20T10:00:42.000Z",
    "documents": [
      {
        "document_id": "doc_1",
        "filename": "invoice-1.pdf",
        "status": "completed",
        "page_count": 3,
        "credits_used": 3,
        "confidence": 0.98,
        "processing_time_ms": 3200,
        "extracted_data": {
          "vendor_name": "Acme Corp",
          "invoice_date": "2026-06-01",
          "total_amount": 1250.75,
          "line_items": [
            { "description": "Cloud Servers", "amount": 1000 },
            { "description": "Support Tier 1", "amount": 250.75 }
          ]
        },
        "error_message": null,
        "created_at": "2026-06-20T10:00:00.000Z",
        "updated_at": "2026-06-20T10:00:42.000Z"
      }
    ]
  }
}

Common Error Responses

HTTP Status	Error Code	Description
`401`	`UNAUTHORIZED`	Invalid or missing API key.
`404`	`RESOURCE_NOT_FOUND`	The requested extraction job does not exist or belongs to another account.

Get Extraction Results

`GET /v1/extractions/:extraction_id/results`

Common Error Responses

On this page