Quickstart
This guide will help you start working with the Rekognita API in minutes. You will get an API key, send your first document, and receive a fully structured result.
1. Get an API Key
Sign up at rekognita.com and go to the Dashboard → API Keys section. Click Create Key, to generate a new key.
Keep your key safe. Do not commit it to public repositories and do not embed it in client-side code.
2. Install SDK (Optional)
You can work directly with the REST API using curl or any HTTP client, or install the official SDK:
# Python
pip install rekognita
# Node.js
npm install @rekognita/sdk3. Send the First Document
Use the following code to send a document for restructuring:
Python
from rekognita import Client
client = Client(api_key="YOUR_API_KEY")
result = client.documents.create(
file=open("invoice.pdf", "rb"),
language="en"
)
print(f"Document ID: {result.id}")
print(f"Status: {result.status}")Node.js
import { Rekognita } from '@rekognita/sdk';
const client = new Rekognita({ apiKey: 'YOUR_API_KEY' });
const result = await client.documents.create({
file: fs.createReadStream('invoice.pdf'),
language: 'en',
});
console.log('Document ID:', result.id);
console.log('Status:', result.status);4. Get the Structured Result
Once processing is complete, you will receive the fully restructured document:
GET /v1/documents/doc_abc123/result
Authorization: Bearer YOUR_API_KEY{
"id": "doc_abc123",
"status": "completed",
"document_type": "invoice",
"result": {
"header": { "company": "Example LLC", "number": "#1234" },
"line_items": [
{ "name": "Service", "quantity": 1, "total": 15000.00 }
],
"totals": { "subtotal": 15000.00, "vat": 3000.00, "total": 18000.00 }
},
"confidence": 0.991,
"language": "en"
}Tip: Use webhooks, to receive notifications automatically, without polling.