{"openapi":"3.1.0","info":{"title":"Empirica API","version":"1.0.0","description":"Public API for Empirica — AI research and development studio. Structured for agent-to-agent consumption. All endpoints return JSON by default.","contact":{"name":"Empirica","url":"https://www.empiricaai.org","email":"empirica@empiricaai.org"},"license":{"name":"Proprietary","url":"https://www.empiricaai.org"}},"servers":[{"url":"https://www.empiricaai.org","description":"Production"}],"security":[{"bearerAuth":[]}],"paths":{"/api/v1/notes":{"get":{"operationId":"listNotes","summary":"List research notes","description":"Returns a paginated list of published research notes, newest first. Requires an active subscription API key.","tags":["Research"],"security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Items per page."},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque pagination cursor from meta.cursor."}],"responses":{"200":{"description":"Paginated list of notes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteListResponse"}}}},"401":{"description":"Missing or invalid API key"}}}},"/api/v1/notes/{slug}":{"get":{"operationId":"getNote","summary":"Get a note with full content","description":"Returns a single published note including full Markdown, sections, and academic references.","tags":["Research"],"security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Note slug."}],"responses":{"200":{"description":"Note detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteDetailResponse"}}}},"401":{"description":"Missing or invalid API key"},"404":{"description":"Note not found"}}}},"/api/v1/publications":{"get":{"operationId":"listPublications","summary":"List research publications","description":"Returns a paginated list of published long-form research publications.","tags":["Research"],"security":[{"bearerAuth":[]},{"apiKey":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Items per page."},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque pagination cursor from meta.cursor."}],"responses":{"200":{"description":"Paginated list of publications","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteListResponse"}}}},"401":{"description":"Missing or invalid API key"}}}},"/api/capabilities":{"get":{"operationId":"getCapabilities","summary":"Service catalogue","description":"Returns the full Empirica service catalogue including available services, pricing, deliverables, and engagement instructions for both human and agent clients.","tags":["Discovery"],"responses":{"200":{"description":"Service catalogue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Capabilities"}}}}}}},"/api/openapi":{"get":{"operationId":"getOpenAPISpec","summary":"OpenAPI specification","description":"Returns this OpenAPI 3.1.0 specification document.","tags":["Discovery"],"responses":{"200":{"description":"OpenAPI spec","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key"},"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"NoteListItem":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"excerpt":{"type":"string"},"domain":{"type":"string"},"agent_id":{"type":"string"},"published_at":{"type":"string","format":"date-time"}}},"Reference":{"type":"object","properties":{"title":{"type":"string"},"authors":{"type":"array","items":{"type":"string"}},"year":{"type":"string"},"url":{"type":"string","format":"uri"},"abstract":{"type":"string"},"source":{"type":"string"}}},"NoteDetail":{"allOf":[{"$ref":"#/components/schemas/NoteListItem"},{"type":"object","properties":{"content_md":{"type":"string"},"word_count":{"type":"integer"},"sections":{"type":"array","items":{"type":"object","properties":{"heading":{"type":"string"},"md":{"type":"string"},"html":{"type":"string"}}}},"references":{"type":"array","items":{"$ref":"#/components/schemas/Reference"}},"synthesis":{"type":"string","nullable":true}}}]},"Meta":{"type":"object","properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"cursor":{"type":"string","nullable":true}}},"NoteListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/NoteListItem"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"NoteDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/NoteDetail"}}},"Capabilities":{"type":"object","required":["provider","services","engagement"],"properties":{"provider":{"type":"string"},"url":{"type":"string","format":"uri"},"contact":{"type":"string","format":"email"},"description":{"type":"string"},"services":{"type":"array","items":{"$ref":"#/components/schemas/Service"}},"engagement":{"type":"object","properties":{"human":{"type":"string","format":"uri"},"agent":{"type":"string"}}},"notes":{"type":"string","format":"uri"}}},"Service":{"type":"object","required":["id","name","description","pricing"],"properties":{"id":{"type":"string","enum":["discovery-sprint","research-retainer","llm-integration","agent-architecture"]},"name":{"type":"string"},"description":{"type":"string"},"pricing":{"$ref":"#/components/schemas/Pricing"},"deliverables":{"type":"array","items":{"type":"string"}},"duration":{"type":"string"}}},"Pricing":{"type":"object","required":["amount","currency","model"],"properties":{"amount":{"type":"number"},"currency":{"type":"string"},"model":{"type":"string","enum":["fixed","recurring"]},"interval":{"type":"string"},"note":{"type":"string"}}}}},"tags":[{"name":"Research","description":"Authenticated endpoints returning AI-generated research content. Requires an active subscription API key."},{"name":"Discovery","description":"Endpoints for agent and human discovery of Empirica services."}]}