---
title: "Poll an extraction job's result"
method: GET
path: "/files"
tags: ["Extract"]
---

# Poll an extraction job's result

`GET /files`

## Request

- Base URL: `https://api.documentpro.ai`
- URL: `https://api.documentpro.ai/files`
- Auth: API key in header `x-api-key`

## Query parameters

- `request_id` string, uuid, required

## Response `200`

Current job state. result_json_data is populated once request_status is completed.

- ExtractionJob
  - `request_id` string, uuid
  - `request_status` 'pending' | 'processing' | 'completed' | 'failed' | 'exception'
  - `response_body` object
    - `file_name` string
    - `file_presigned_url` string, uri, nullable
    - `user_error_msg` string, nullable
    - `template_id` string, uuid
    - `template_type` string
    - `template_title` string
    - `num_pages` integer
    - `human_verification_status` 'pending' | 'approved' | 'rejected'
    - `has_missing_required_fields` boolean
    - `result_json_data` object, nullable: Populated once request_status is completed. Shape depends on the Workflow's template_schema.
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400`: Malformed request or invalid arguments.
- `401`: Missing or invalid x-api-key.
- `403`: API key does not have access to the requested resource, or a plan limit was hit.
- `404`: The requested resource does not exist on this account.
- `500`: Something went wrong on DocumentPro's side.

---

[API](https://skmtc.dev/documentpro/apis/documentpro-api.md) · [All operations](https://skmtc.dev/documentpro/apis/documentpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/documentpro/apis/documentpro-api/revisions/05d6bd485e28?raw)