curl --request POST \
--url https://api.ai-baseline.dev/{org}/{base}/v2/query \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"query": "What supply chain risks did Apple disclose in its 10-K filings?"
}
'
{
"request_id": "<string>",
"notices": [
{
"code": "<string>",
"message": "<string>"
}
],
"metadata_distribution": {},
"metadata_dashboard": "<string>",
"evidence": "<string>",
"evidence_instructions": "<string>",
"agent_context": {
"text": "<string>",
"content_type": "text/markdown",
"source_fields": [
"<string>"
],
"content_parts": [
{
"text": "<string>",
"type": "text"
}
]
},
"source_links": {
"status": "complete",
"total_sources": 1,
"returned_sources": 1,
"total_passages": 1,
"returned_passages": 1,
"sources": {}
},
"image_evidence": {
"status": "complete",
"total_selected_images": 1,
"returned_images": 1,
"returned_bytes": 1,
"images": {},
"bindings": [
{
"evidence_id": "<string>",
"entry_id": "<string>",
"image_refs": [
"<string>"
],
"support_kind": "visual"
}
],
"omissions": [
{
"evidence_id": "<string>",
"entry_id": "<string>",
"reason": "image_count_budget"
}
],
"schema_version": 1
},
"summary": {
"domain": "<string>",
"mode": "basic",
"effort": "low",
"evidence_count": 123,
"submitted_metadata_filters": {},
"applied_metadata_filters": {},
"warnings": [
"<string>"
]
},
"coverage": {
"status": "complete",
"requirement_count": 1,
"covered_requirement_count": 1,
"requirements": [
{
"id": "<string>",
"label": "<string>",
"query": "<string>",
"status": "covered",
"retrieved_evidence_count": 1,
"returned_evidence_count": 1
}
],
"omitted_requirements": [
"<string>"
],
"limitations": [
"planning_fallback"
]
},
"evidence_budget": {
"estimated_tokens": 1,
"available_evidence_count": 1,
"returned_evidence_count": 1,
"truncated": true,
"requested_max_tokens": 2,
"estimator": "chars_div_4_v1"
},
"retrieval_plan": {
"queries": [
{
"query": "<string>",
"label": "<string>",
"applied_metadata_filters": {}
}
]
}
}
API Reference
Query knowledge-base evidence
Runs a query against the knowledge base selected by the server URL and returns one JSON response. The S&P 500 request examples apply to baseline/sandp500; use queries and metadata fields appropriate to your selected base.
POST
/
query
curl --request POST \
--url https://api.ai-baseline.dev/{org}/{base}/v2/query \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"query": "What supply chain risks did Apple disclose in its 10-K filings?"
}
'
{
"request_id": "<string>",
"notices": [
{
"code": "<string>",
"message": "<string>"
}
],
"metadata_distribution": {},
"metadata_dashboard": "<string>",
"evidence": "<string>",
"evidence_instructions": "<string>",
"agent_context": {
"text": "<string>",
"content_type": "text/markdown",
"source_fields": [
"<string>"
],
"content_parts": [
{
"text": "<string>",
"type": "text"
}
]
},
"source_links": {
"status": "complete",
"total_sources": 1,
"returned_sources": 1,
"total_passages": 1,
"returned_passages": 1,
"sources": {}
},
"image_evidence": {
"status": "complete",
"total_selected_images": 1,
"returned_images": 1,
"returned_bytes": 1,
"images": {},
"bindings": [
{
"evidence_id": "<string>",
"entry_id": "<string>",
"image_refs": [
"<string>"
],
"support_kind": "visual"
}
],
"omissions": [
{
"evidence_id": "<string>",
"entry_id": "<string>",
"reason": "image_count_budget"
}
],
"schema_version": 1
},
"summary": {
"domain": "<string>",
"mode": "basic",
"effort": "low",
"evidence_count": 123,
"submitted_metadata_filters": {},
"applied_metadata_filters": {},
"warnings": [
"<string>"
]
},
"coverage": {
"status": "complete",
"requirement_count": 1,
"covered_requirement_count": 1,
"requirements": [
{
"id": "<string>",
"label": "<string>",
"query": "<string>",
"status": "covered",
"retrieved_evidence_count": 1,
"returned_evidence_count": 1
}
],
"omitted_requirements": [
"<string>"
],
"limitations": [
"planning_fallback"
]
},
"evidence_budget": {
"estimated_tokens": 1,
"available_evidence_count": 1,
"returned_evidence_count": 1,
"truncated": true,
"requested_max_tokens": 2,
"estimator": "chars_div_4_v1"
},
"retrieval_plan": {
"queries": [
{
"query": "<string>",
"label": "<string>",
"applied_metadata_filters": {}
}
]
}
}
Authorizations
Body
application/json
Available options:
basic, research, agentic_research Available options:
low, medium, high Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
Successful Response
Strict allowlist for every public production query response.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes