---
title: AI Document ID Extraction API
slug: extract-id-data
url: https://apyhub.com/apyhub/service/extract-id-data
provider: ApyHub
tags: [id-extraction, document-intelligence, identity-verification, ocr, document-parsing]
auth: api_key
---

# AI Document ID Extraction API

What it does ID Data Extraction lets you send an ID document as a file or by URL and get extracted identity data back. Choose the requestedservice value to route the request to apyhub or azure, and, for Azure-backed requests, provide the Azure credential fields supported by the endpoint. Use POST /…

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/ai/document/extract/id/file` | What it does Uploads an ID document file and returns parsed extraction results. The response is a J… | 500 |
| POST | `/ai/document/extract/id/url` | Extract id data (URL input) Extract id data (URL input) Analyze id at the provided URL. Note: The o… | 500 |

## About

## What it does
ID Data Extraction lets you send an ID document as a file or by URL and get extracted identity data back. Choose the `requested_service` value to route the request to `apyhub` or `azure`, and, for Azure-backed requests, provide the Azure credential fields supported by the endpoint.

Use `POST /file` to upload a binary `file`, or `POST /url` to point the service at a `url`. Both endpoints accept the same service selection pattern, and the URL flow also supports an `azure` object with `key`, `region`, `endpoint`, `account_id`, and `access_token` for custom Azure configuration.

The response returns a `data` object with `azure` and `apyhub` objects. `azure` contains the raw Azure Document Intelligence parsing output, while `apyhub` contains the structured ApyHub ID extraction output. That makes the service useful when you need to read identity documents from uploads or hosted files and compare the structured result with the underlying Azure parse.

Typical uses include onboarding flows, account verification, and document intake pipelines where you need extracted ID details from PDFs or other supported file inputs.

| Provider (requested_service) | Atoms |
|------------------------------|------:|
| Azure                        |   500 |
| ApyHub                       |  2000 |

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/extract-id-data