# Get Document Data

Source: https://www.digiparser.com/docs/api/getDocumentData

# Get Document Data

Server URL`loading...`

GET

/`api`/`v1`/`process`/`{parserId}`/`files`/`data`

Send

Authorization

Path

Query

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`.

## [Authorization](#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](#path-parameters)

parserId\*string

The ID of the parser

Format`uuid`

## [Query Parameters](#query-parameters)

documentId?string

The ID of the document to retrieve

Format`uuid`

externalId?string

The external tracking ID associated with the document (provided during upload)

## [Response Body](#response-body)

### 200

`application/json`

### 400

`application/json`

### 403

`application/json`

### 404

`application/json`

cURL

JavaScript

Go

Python

Java

C#

```
curl -X GET "https://api.digiparser.com/api/v1/process/d1458cd7-8692-488f-8b3f-0fddade05f9c/files/data"
```

200400403404

```
{
  "data": {
    "currency": "USD",
    "Buyer Name": "Abcxyz Traders",
    "Line Items": [
      {
        "sku": null,
        "quantity": 3,
        "unit_price": 1129.03,
        "description": "Drag Series Transmission Build - A WD DSM",
        "total_price": 3387.09
      }
    ],
    "Order Date": "2021-11-24",
    "Buyer Email": "[email protected]",
    "Order Number": "1437"
  },
  "error": "Timed out while processing document",
  "metadata": {
    "id": "2b9b1243-3d94-42b0-9515-729c7404e3b7",
    "name": "sample-invoice.pdf",
    "externalId": "doc-123",
    "custom": {
      "batchId": "xyz",
      "customerId": "pqr"
    },
    "url": "https://documents.digiparser.com/resources/t/01dd1542-7aac-463c-8eda-a7e042fd5876/p/d1458cd7-8692-488f-8b3f-0fddade05f9c/d/2b9b1243-3d94-42b0-9515-729c7404e3b7/sample-invoice.pdf?sig=70adb475a196e71cd2f82c40623bb9be94647aff0d187120ee39c9fd9c7a10d0",
    "status": "processed",
    "isProcessed": true,
    "isFailed": false,
    "thumbnail": "https://documents.digiparser.com/resources/t/01dd1542-7aac-463c-8eda-a7e042fd5876/p/d1458cd7-8692-488f-8b3f-0fddade05f9c/d/2b9b1243-3d94-42b0-9515-729c7404e3b7/thumbnail.png?sig=0c4f8f8d1c4ede6256afb7eec5ac4830cc9eb1c27e78895d72a21f03e681b6df",
    "createdAt": "2026-01-23T18:11:47.319Z",
    "updatedAt": "2026-01-23T18:12:29.860Z",
    "pageCount": 1,
    "isApproved": true,
    "assignee": "John Doe",
    "field_metadata": {}
  }
}
```

```
{
  "error": true,
  "message": "Parser ID mismatch"
}
```

```
{
  "error": true,
  "message": "Access denied"
}
```

```
{
  "error": true,
  "message": "Document not found",
  "notFound": [
    {
      "type": "documentId",
      "value": "string"
    }
  ]
}
```

[

Delete Documents POST

Delete documents so their \`externalId\` values can be reused on re-upload. \*\*Request body:\*\* Provide \`documentIds\` and/or \`externalIds\`. - If you send \`documentIds\`, \`externalIds\` is optional. - If you send \`externalIds\`, \`documentIds\` is optional. - You must provide at least one of them.

](/docs/api/deleteDocuments)[

Reprocess Document POST

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\`.

](/docs/api/reprocessDocument)