---
title: Invoice Parsing API
slug: parse-invoice
url: https://apyhub.com/sharpapi/service/parse-invoice
provider: SharpAPI
categories: [Ingestion Kit, Document Intelligence Kit]
tags: [business, finance, invoice]
auth: api_key
version: 1.0.0
service_type: job
endpoints: 2
atoms: 1-50
alias: sharpapi-ai-invoice-parser
---

# Invoice Parsing API

Submit invoice files and poll for structured results. Extracts buyer, seller, invoice details, financial totals, and line items from PDFs.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/sharpapi/parse-invoice` | What it does Submits an invoice file for asynchronous parsing and returns identifiers for tracking… | 50 |
| GET | `https://api.eu.apyhub.com/sharpapi/parse-invoice/job/status/:job_id` | What it does Checks the processing status of an asynchronous invoice parsing job by job ID. When th… | 1 |

## Endpoint reference

### Submit Invoice Parse Job

`POST https://api.eu.apyhub.com/sharpapi/parse-invoice` · 50 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `file` | body | string (binary) | yes | Provide the Invoice file in PDF, DOC, DOCX, PNG, JPG, JPEG, TIFF, or TIF formats. |
| `language` | body | string | no | Specify the language of the Invoice. Defaults to English. Default: `English`. |

#### Quickstart

Submit an invoice file for parsing by uploading it as JSON in the request body.

```bash
curl -X POST "https://api.eu.apyhub.com/sharpapi/parse-invoice" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/invoice.pdf"
```

#### What you'll get back

Returns a JSON object with a `job_id` string — the UUID of the submitted job. Poll the job status endpoint with this id to retrieve the result.

```json
{
  "job_id": "a233324c-02cb-4c89-9ec4-fbe736758586"
}
```

### Check Invoice Parse Status

`GET https://api.eu.apyhub.com/sharpapi/parse-invoice/job/status/:job_id` · 1 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `job_id` | path | string | yes |  |

#### Quickstart

Check the status of an invoice parsing job by its job ID.

```bash
curl -X GET "https://api.eu.apyhub.com/sharpapi/parse-invoice/job/status/:job_id" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` object. `data` includes `id` (the job UUID), `type` (for example, `api_job_result`), and `attributes`, which contains `status` and may include a `result` array with parsed invoice data.

```json
{
  "data": {
    "id": "2f1c8d8e-4c4b-4d1a-9e7e-8f8f5d3d2f11",
    "type": "api_job_result",
    "attributes": {
      "status": "success"
    }
  }
}
```

## About

## What it does
Invoice Parser takes an invoice file, submits it for asynchronous processing, and returns structured invoice data you can use in your application. Send a PDF, DOC, DOCX, PNG, JPG, JPEG, TIFF, or TIF file, and optionally set the document language. You get back a job ID for polling.

Use it when you need to turn supplier invoices into machine-readable records without building your own extraction pipeline. The status endpoint reports the job state as `queued`, `running`, `success`, or `failed`, and when processing completes it returns the extracted result set.

The parsed output can include buyer details with a billing address, seller details with a VAT ID and address, invoice metadata such as currency, issue date, and invoice number, a boolean `is_invoice` flag, financial totals including subtotal, total payable, and total tax amount, plus line items with quantity, subtotal, unit price, and description.

Invoice Parser is a good fit for accounts payable workflows, expense systems, document ingestion, and back-office automation where invoice fields need to be captured consistently from scanned or digital files.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

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