API Introduction

The VATextractREST API enables you to integrate invoice extraction into your applications.

Base URL

https://vatextract.com/api

Authentication

All API requests require authentication via Clerk. Include your session token in the Authorization header:

Authorization: Bearer YOUR_SESSION_TOKEN

For server-to-server integrations, use API keys (coming soon). Contact support for early access.

Request Format

Content-Type: application/json for most endpoints
File uploads: multipart/form-data

Response Format

All responses return JSON:

{
  "data": { ... },
  "error": null
}

Error Responses

{
  "data": null,
  "error": "Unauthorized"
}

Status Code	Description
200	Success
400	Bad request (invalid parameters)
401	Unauthorized (missing/invalid token)
404	Resource not found
500	Server error

Rate Limiting

Tier	Requests/minute
Free	60
Pro	300
Enterprise	Custom

Rate limit headers are included in responses:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 55
X-RateLimit-Reset: 1704067200

Endpoints

Upload Invoice

POST /api/upload

List Invoices

GET /api/invoices

Get Invoice

GET /api/invoices/:id

Export Data

GET /api/invoices/export

SDKs

Official SDKs coming soon. For now, use standard HTTP clients:

cURL
JavaScript

curl -X GET https://vatextract.com/api/invoices \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch('https://vatextract.com/api/invoices', {
  headers: {
    'Authorization': `Bearer ${token}`
  }
});
const data = await response.json();

Getting Started

Features

Integrations

Base URL

Authentication

Request Format

Response Format

Error Responses

Rate Limiting

Endpoints

Upload Invoice

List Invoices

Get Invoice

Export Data

SDKs

​Base URL

​Authentication

​Request Format

​Response Format

​Error Responses

​Rate Limiting

​Endpoints

Upload Invoice

List Invoices

Get Invoice

Export Data

​SDKs

Base URL

Authentication

Request Format

Response Format

Error Responses

Rate Limiting

Endpoints

SDKs