{"openapi":"3.1.0","info":{"title":"Almonax API","version":"1.0.0","description":"Verticalized intelligence reports for VC/PE/M&A/recruiting professionals + AI agents. Agent rate = human rate (no discrimination).","contact":{"email":"hello@almonax.com"},"license":{"name":"Proprietary"}},"servers":[{"url":"https://www.almonax.com","description":"Production"}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key from /account/api-keys. Prefix: ak_live_"}},"schemas":{"Balance":{"type":"object","required":["balance","currency"],"properties":{"balance":{"type":"integer","description":"Credit balance"},"currency":{"type":"string","enum":["credits"]}}},"RunReportRequest":{"type":"object","required":["type","topic"],"properties":{"type":{"type":"string","enum":["quick_scan","standard","premium","role_map","jd_optimizer","org_snapshot","acquihire_candidates","competitive_talent_brief","exit_radar","fund_tracker","risk_pulse"]},"topic":{"type":"string","minLength":5,"maxLength":2000},"filters":{"type":"object","additionalProperties":true}}},"RunReportResponse":{"type":"object","required":["id","status","credits_spent","poll_url"],"properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","running","complete","failed"]},"credits_spent":{"type":"integer"},"poll_url":{"type":"string"}}},"Report":{"type":"object","required":["id","type","status","topic","credits_spent","created_at"],"properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["quick_scan","standard","premium","role_map","jd_optimizer","org_snapshot","acquihire_candidates","competitive_talent_brief","exit_radar","fund_tracker","risk_pulse"]},"status":{"type":"string","enum":["queued","running","complete","failed"]},"topic":{"type":"string"},"title":{"type":["string","null"]},"content_md":{"type":["string","null"]},"summary_md":{"type":["string","null"]},"credits_spent":{"type":"integer"},"created_at":{"type":"string","format":"date-time"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"detail":{"type":"string"}}}}},"security":[{"BearerAuth":[]}],"paths":{"/api/v1/balance":{"get":{"summary":"Get credit balance","operationId":"getBalance","responses":{"200":{"description":"Current balance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Balance"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/reports":{"post":{"summary":"Generate a new report","operationId":"runReport","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Optional. Repeat calls with the same key + body within 24h return the cached response (no double-charge)."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunReportRequest"}}}},"responses":{"200":{"description":"Report queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunReportResponse"}}}},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient credits"},"422":{"description":"Invalid request"}}}},"/api/v1/reports/{id}":{"get":{"summary":"Get a report by id","operationId":"getReport","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Report content","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Report"}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found or not owned by API key holder"}}}}}}