API Reference
Ask
Authorization
InfraApiKey AuthorizationBearer <token>
Send sk_live_* (production) or sk_test_* (test mode).
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/json
application/problem+json
curl -X POST "https://example.com/v1/ask" \ -H "Content-Type: application/json" \ -d '{ "question": "string" }'{ "answer_md": "Uber's Total Company Gross Bookings reached **$53.72 billion** in Q1 2026 [1], growing **25% year over year** and **21% on a constant-currency basis** [1].", "citations": [ { "n": 1, "src_id": "src_kpi2_be16edbfefe50d35", "dataset": "kpis", "symbol": "UBER", "period": "2026Q1", "quote": "Gross Bookings grew 25% YoY to $53.7 billion, and 21% on a constant currency basis.", "source_url": "https://www.sec.gov/Archives/edgar/data/1543151/000154315126000019/0001543151-26-000019-index.htm" } ], "data_points": [ { "metric_key": "total_company_gross_bookings", "period": { "calendar": null, "fiscal": "FY2026-Q1", "end_date": "2026-03-31", "kind": "quarter" }, "value": { "raw": 53720000000, "normalized": 53720000000, "unit": "USD", "original_unit": "USD", "conversion_factor": 1 }, "src_id": "src_kpi2_be16edbfefe50d35", "symbol": "UBER" } ], "confidence": "high", "not_found": null, "credits": { "used": 1, "remaining": 24 }, "model_version": "ask-v1.0", "request_id": "req_2f58c4ee6b1b2f12"}{ "type": "https://docs.signals.ai/errors/invalid-key", "title": "Invalid API key", "status": 401, "detail": "Missing or invalid API key.", "request_id": "req_0dc23f9b4a0f8f2a", "instance": "/v1/companies/UBER"}{ "type": "https://docs.signals.ai/errors/credits-exhausted", "title": "Credits exhausted", "status": 402, "detail": "Not enough ask credits: requested 5, remaining 0.", "request_id": "req_540fba8924d152f6", "instance": "/v1/ask"}{ "detail": [ { "type": "string_too_short", "loc": [ "body", "query" ], "msg": "String should have at least 2 characters", "input": "q", "ctx": { "min_length": 2 } } ]}{ "type": "https://docs.signals.ai/errors/rate-limited", "title": "Rate limit exceeded", "status": 429, "detail": "Your current plan's burst or daily quota has been exceeded.", "request_id": "req_8b44f5d1a8d1f48b", "instance": "/v1/search"}