Sign In

API Reference

The Tracore API is a RESTful JSON API for document parsing and structured data extraction.

Base URL

https://api.tracore.io

Authentication

All requests require an API key passed in the x-api-key header:

curl https://api.tracore.io/workspaces \
  -H "x-api-key: dsk_your_api_key_here"

See Authentication for details on creating and managing API keys.

Response format

All responses return JSON. Successful single-resource responses return the resource object directly. List endpoints return a paginated envelope:

{
  "total": 42,
  "page": 1,
  "pageSize": 20,
  "data": [
    // array of resources
  ]
}

Environment scoping

Documents, runs, and webhooks are scoped to an environment. Pass the env query parameter to target a specific environment:

GET /workspaces/my-workspace/schemas/invoice/documents?env=staging

Valid values are production, staging, and development. If omitted, the environment defaults to production.

Schemas are workspace-scoped and shared across all environments — they do not use the env parameter.

Content types

  • Request bodies: application/json for most endpoints, multipart/form-data for file uploads.
  • Response bodies: application/json for all endpoints except document downloads.