Extract invoice data (URL input)

**Method:** POST
**Apiosk URL:** https://gateway.apiosk.com/apyhub-ai-document-extract-invoice/ai/document/extract/invoice/url
**Request content type:** application/json
**Response content type:** application/json

What it does

Extracts invoice data from a document available at a URL and returns parsed results in a JSON object. The response includes separate top-level result objects for Azure and ApyHub parsing outputs.

Request Body

| Parameter | Type | Mandatory | Description |
| --------- | ---- | --------- | ----------- |
| url | String | Yes | The invoice document URL to process. Must be a URI. |
| azure | Object | No | Optional custom credentials for Azure services. |
| azure.key | String | No | Azure subscription key. |
| azure.region | String | No | Azure service region. |
| azure.endpoint | String | No | Azure endpoint URL. |
| azure.account_id | String | No | Azure account ID. |
| azure.access_token | String | No | OAuth access token for Azure service. |
| requested_service | ENUM | No | Which parsing service to use. Allowed values: azure, apyhub. Default: apyhub. |

Response

Returns a JSON object with a data object field. Inside data, the response may include azure and apyhub object fields containing the corresponding parsing outputs.

| Parameter | Type | Mandatory | Description |
| --------- | ---- | ---- | ----------- |
| data | Object | No | Result wrapper object. |
| data.azure | Object | No | Raw Azure Document Intelligence parsing output. |
| data.apyhub | Object | No | Structured ApyHub Invoice Extraction parsing output. |

Quickstart

Send an invoice PDF URL to extract its data.

bash
curl -X POST "https://gateway.apiosk.com/apyhub-ai-document-extract-invoice/ai/document/extract/invoice/url" \
-H "PAYMENT-SIGNATURE: $PAYMENT_SIGNATURE" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/invoice.pdf"}'

What you'll get back

Returns a JSON object with a data object field. data.azure contains the raw Azure Document Intelligence parsing output, and data.apyhub contains the structured ApyHub invoice extraction output.

json
{
"data": {
"azure": {},
"apyhub": {}
}
}

Payment and authentication

Do not send an apy-token. Apiosk injects the APYHub credential server-side. The first unpaid request returns HTTP 402 Payment Required with a PAYMENT-REQUIRED header. Sign an accepted USDC payment and retry the same request with the proof in PAYMENT-SIGNATURE (or use an Apiosk/x402-aware agent client that performs this exchange automatically).

The $PAYMENT_SIGNATURE placeholder in the example is the signed proof obtained from that initial 402 response.

Source

Parameter definitions and limits were synchronized from [APYHub's official documentation](https://apyhub.com/apyhub/service/extract-invoice-data) on 2026-07-18.