That Is A Q API Specification

API Overview

The That Is A Q REST API allows you to programmatically submit questions, retrieve AI-powered answers, and manage query insights. All endpoints are secured via API keys and return JSON responses.

🌐

BASE URL

https://api.thatisaq.com/v1

Rate Limits

Plan	Requests/min	Burst
Developer	60	100
Team	300	500
Enterprise	Unlimited	Custom

Exceeding limits returns 429 Too Many Requests. Retry-After header indicates cooldown.

Authentication

Authenticate using API keys via the Authorization header. Keys can be generated from your dashboard.

Header Authorization: Bearer <your-api-key>

POST /v1/queries HTTP/1.1
Host: api.thatisaq.com
Authorization: Bearer q_sk_live_8f3a9c2b1d4e5f6a7b8c9d0e1f2a3b4c
Content-Type: application/json

{
  "question": "How does quantum computing impact cryptography?",
  "context": "academic",
  "max_tokens": 500
}

Endpoints

Click any endpoint to view parameters, request/response examples, and status codes.

System

GET /health Check API status ▼

Returns the current operational status of the That Is A Q API infrastructure.

200 OK

{
  "status": "healthy",
  "version": "1.2.4",
  "timestamp": "2025-01-15T08:30:00Z",
  "services": {
    "query_engine": "operational",
    "answer_cache": "operational",
    "database": "operational"
  }
}

Queries

POST /queries Create a new question ▼

Submit a new query to the Q engine. Processing is asynchronous; poll using the returned query_id.

Parameter	Type	Description
`question`	string	Required. The question text.
`context`	string	Optional. Domain context (e.g., technical, creative).
`max_tokens`	integer	Optional. Max response length. Default: 256.

201 Created

{
  "query_id": "q_9x8y7z6w5v4u3t2s",
  "status": "processing",
  "created_at": "2025-01-15T08:35:12Z",
  "estimated_completion": 3.2
}

GET /queries/{id} Retrieve query status ▼

Check the processing status and metadata of a submitted query.

Parameter	In	Description
`id`	path	Required. The query identifier.

200 OK

{
  "query_id": "q_9x8y7z6w5v4u3t2s",
  "status": "completed",
  "question": "How does quantum computing impact cryptography?",
  "metadata": {
    "processing_time": 2.8,
    "tokens_used": 412
  }
}

PUT /queries/{id} Update query parameters ▼

Modify parameters of a queued or processing query. Cannot modify completed queries.

Parameter	Type	Description
`id`	string	Path parameter
`context`	string	Override domain context
`priority`	string	"normal" or "high"

200 OK

{
  "query_id": "q_9x8y7z6w5v4u3t2s",
  "status": "updated",
  "message": "Parameters successfully applied"
}

DELETE /queries/{id} Cancel/Delete query ▼

Cancel a processing query or delete a completed one from history. Does not refund tokens.

204 No Content

Answers

GET /answers/{query_id} Fetch generated answer ▼

Retrieve the final answer once query processing is complete. Returns cached responses for subsequent calls.

Parameter	In	Description
`query_id`	path	Required. Reference query ID.

200 OK

{
  "query_id": "q_9x8y7z6w5v4u3t2s",
  "answer": "Quantum computing threatens classical cryptographic protocols like RSA and ECC by...",
  "confidence": 0.94,
  "sources": [
    "Nature: Quantum Supremacy", "NIST Post-Quantum Crypto"
  ],
  "generated_at": "2025-01-15T08:35:15Z"
}