API Reference

API Reference

Complete reference documentation for the Cortiqa REST API. All endpoints use JSON for request and response bodies and require authentication via API key.


Base URL

Production Base URL
https://api.cortiqa.co/api/v1

All Cortiqa REST endpoints are relative to this base URL.

Authentication

All API requests require authentication. Pass your secret key in the standard Authorization header:

Terminal
curl https://api.cortiqa.co/api/v1/chat/completions \
  -H "Authorization: Bearer sk-cortiqa-YOUR_API_KEY" \
  -H "Content-Type: application/json"

Endpoints

MethodEndpointDescription
POST/chat/completionsOpenAI-compatible chat & reasoning completions (streaming supported)
GET/modelsList all available Cortiqa models
POST/embeddingsGenerate text embeddings for semantic search
POST/chats/:id/streamLive SSE stream for interactive chat sessions
GET/statusHealth check & LPU infrastructure status

Error Handling

The API returns standard HTTP status codes:

CodeMeaning
200Success
400Bad request (invalid parameters)
401Unauthorized (invalid API key)
403Forbidden (insufficient permissions)
404Not found
429Rate limit exceeded
500Internal server error
529API overloaded

See the Errors reference for detailed error handling guidance.

Was this page helpful?