DigiParserDigiParser
HomeSupportGet Started
GuidesAPI ReferenceChangelogLegal

Reprocess Document

POST
/api/v1/process/{parserId}/reprocess

Re-run extraction for an already uploaded document (useful after adding new parser fields).

Request body: Provide exactly one of documentId or externalId.

  • documentId and externalId cannot be sent together.
  • If neither is provided, the API returns 400.

Authorization

bearerAuth
authorization<token>

Your API key. Include it directly in the Authorization header as the API key value (e.g., 'authorization: your-api-key-here')

In: header

Path Parameters

parserId*string

The ID of the parser

Formatuuid

Request Body

application/json

documentId?string

Existing document ID to reprocess.

Formatuuid
externalId?string

External ID of the document to reprocess (for this parser).

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://app.digiparser.com/api/v1/process/d1458cd7-8692-488f-8b3f-0fddade05f9c/reprocess" \  -H "Content-Type: application/json" \  -d '{}'
{
  "success": true,
  "documentId": "4704590c-004e-410d-adf7-acb7ca0a7052",
  "status": "processing"
}
{
  "error": true,
  "message": "Parser ID mismatch"
}
{
  "error": true,
  "message": "Parser ID mismatch"
}
{
  "error": true,
  "message": "Access denied"
}
{
  "error": true,
  "message": "Document not found",
  "notFound": [
    {
      "type": "documentId",
      "value": "string"
    }
  ]
}
{
  "error": true,
  "message": "Parser ID mismatch"
}
{
  "error": true,
  "message": "Parser ID mismatch"
}
{
  "error": true,
  "message": "Parser ID mismatch"
}

Get Document Data GET

Retrieve the extracted data from a processed document. **What you need:** - **Parser ID**: Find it in Parser Settings → General Settings - Either: - **Document ID**: Get this from the upload response (`documentId` field), or - **externalId**: The external tracking ID you provided during upload - **API Key**: Generate it from Team Settings → API Keys **How to use:** - Endpoint: `GET /api/v1/process/{parserId}/files/data?documentId={documentId}` - OR: `GET /api/v1/process/{parserId}/files/data?externalId={externalId}` - Include your API key in the `Authorization` header **What you get:** - **data**: Extracted field values and table data matching your parser's schema - **metadata**: Document information including status, timestamps, and file details **Note:** If the document is still processing, the `data` field will be empty and `status` will be `processing`. Poll this endpoint periodically until `status` is `processed` or `failed`.

Upload File POST

Upload a document file to process and extract data. **What you need:** - **Parser ID**: Find it in Parser Settings → General Settings - **API Key**: Generate it from Team Settings → API Keys **How to use:** - Endpoint: `POST /api/v1/process/{parserId}/files` - Send the request as `multipart/form-data` with field name `file` - (Optional) Provide additional fields: - `folderId`: Folder UUID to assign the created document(s) - `externalIds`: JSON-encoded array of external IDs (one per uploaded file) - `custom`: JSON-encoded array of tracking objects (one per uploaded file) - Include your API key in the `Authorization` header **What you get:** - Response includes `documentId` for the uploaded document - Document status will be `processing` initially - Use the `documentId` with the "Get Document Data" endpoint to retrieve extracted data once processing is complete