API Overview

Rekognita API is a REST API for document processing. The base URL for all requests is:

https://api.rekognita.com

Authentication

All requests require an API key in the Authorization header:

Authorization: Bearer rk_sk_your_key_here

Learn more: API Authorization

Request Format

The API accepts requests in multipart/form-data format for file uploads and application/json for other operations.

POST /v1/documents/convert HTTP/1.1
Host: api.rekognita.com
Authorization: Bearer rk_sk_your_key
Content-Type: multipart/form-data

file=@document.pdf
output_format=markdown

Response Format

All responses are returned in JSON:

{
  "id": "doc_abc123",
  "status": "completed",
  "pages": 5,
  "content": "# Document Title\n\nContent...",
  "metadata": {
    "format": "markdown",
    "processing_time_ms": 1240,
    "model": "rekognita-accurate"
  }
}

Processing Models

Rekognita offers three processing models:

Model	Speed	Quality	Use Case
`rekognita-fast`	~0.8s/page	High	High volume, real time
`rekognita-balanced`	~1.5s/page	Very High	Recommended default
`rekognita-accurate`	~3s/page	Highest	Critical documents, finance

Output Formats

Rekognita supports several output formats — from simple text to a graph structure of the document:

Graph Structure — complete document structure with elements and relationships
Word/PDF — restructured documents in Word or PDF format
Markdown & HTML — clean text formats retaining structure
JSON Schema — data extraction matching your JSON schema

Versioning

The API uses URL versioning: /v1/. When breaking changes are introduced, a new version will be created (/v2/). Old versions are supported for a minimum of 12 months.