Ontwikkelaars

Een extractie-API voor betrouwbaar dagelijks gebruik.

Upload bestanden, vraag statussen op, ontvang ondertekende webhooks en lees genormaliseerde velden met aanvraag-ID’s, idempotentie, testtokens en een OpenAPI-contract.

API-toegang aanvragen API-documentatie

API-levenscyclus

Opnieuw proberen, asynchroon verwerken en gerichte ondersteuning.

Uploads zijn asynchroon en idempotent. Voltooide documenten leveren velden; geblokkeerde of mislukte documenten leveren bruikbare context.

Upload

curl -X POST "https://www.exdata.app/api/v1/documents" \
  -H "Authorization: Bearer $EXDATA_API_TOKEN" \
  -H "Idempotency-Key: invoice-upload-001" \
  -F "file=@invoice.pdf" \
  -F "locale=en" \
  -F "custom_types[]=invoice"

Resultaat

{
  "status": "completed",
  "mode": "live",
  "is_e_invoice": true,
  "extractions": {
    "type": {
      "value": "invoice",
      "candidates": ["invoice"]
    },
    "document_number": {
      "value": "RE-2026-1048",
      "candidates": ["RE-2026-1048"]
    },
    "sender_name": {
      "value": "Meyer Supply GmbH",
      "candidates": ["Meyer Supply"]
    },
    "recipient_name": {
      "value": "Northwind Operations Ltd.",
      "candidates": ["Northwind Operations"]
    },
    "payment_due_date": {
      "value": "2026-06-14",
      "candidates": ["14.06.2026"]
    },
    "net_amount": {
      "value": "1079.50",
      "candidates": ["1,079.50"]
    },
    "tax_breakdowns": {
      "value": [
        {
          "taxable_amount": "1079.50",
          "tax_amount": "205.10",
          "tax_rate": "19.00",
          "tax_collection_mechanism": "seller_collected"
        }
      ],
      "candidates": ["VAT 19% 205.10"]
    },
    "gross_amount": {
      "value": "1284.60",
      "candidates": ["EUR 1,284.60"]
    },
    "currency": {
      "value": "EUR",
      "candidates": ["EUR"]
    },
    "iban": {
      "value": "DE89370400440532013000",
      "candidates": ["DE89 3704 0044 0532 0130 00"]
    }
  },
  "latest_extraction_run": {
    "extraction_schema_version": "2026-08-28.1",
    "normalization_version": "base:2026-10-21.3"
  }
}

Integratiepad

Test het productiegedrag voordat je productiecredits verbruikt.

Maak een testtoken

Testtokens gebruiken dezelfde endpoints, validatie, idempotentie, webhooks en foutstructuur als productietokens.

Upload representatieve bestanden

Gebruik representatieve pdf’s, eigen labels en de juiste taal voor elk document. Idempotentiesleutels voorkomen dat herhaalde uploads duplicaten opleveren.

Stap over op productietokens

Schakel over zodra polling, webhooks, foutafhandeling en downstream mapping veilig zijn getest.

Na de lancering

Integratiedetails zijn zichtbaar wanneer ze ertoe doen.

Als de verwerking mislukt, een document wordt geblokkeerd of de extractie anders uitpakt dan verwacht, krijgt je integratie machineleesbare details. Je team kan de verwerking ook in de werkruimte bekijken.

Aanvraag-ID’s: Elk API-antwoord bevat een aanvraag-ID waarmee de ondersteuning een melding aan het juiste verzoek kan koppelen.
Ondertekende webhookheaders: Leveringen bevatten headers voor gebeurtenis, levering, tijdstip en handtekening voor verificatie door de ontvanger.
Machineleesbare fouten: Fouten bevatten een bericht, code en aanvraag-ID, zodat je integratie gericht opnieuw kan proberen of een melding kan doorgeven aan de ondersteuning.
OpenAPI-contract: Het API-contract van v1 is gepubliceerd en gevalideerd, zodat SDK’s, integraties en documentatie op elkaar aansluiten.
Limieten en backoff: Limieten per token en account beschermen de dienst en bieden een helder model voor nieuwe pogingen.

Documentatie

Begin met de snelstart en sluit daarna polling of webhooks aan.

API-documentatie OpenAPI YAML