Technical documentation for integrating with the IRB system
All API requests require authentication
# Include your API key in the request header:
Authorization: Bearer YOUR_API_KEY
API keys can be generated from your organization settings. Keep your API keys secure and never share them publicly.
https://irb.sova.health/api
All endpoints are relative to this base URL. Use HTTPS for all requests.
Manage research studies and protocols
/api/studiesList all studies/api/studiesCreate a new study/api/studies/:idGet study details/api/studies/:idUpdate a study/api/studies/:idDelete a studyHandle IRB submissions and reviews
/api/submissionsList all submissions/api/submissionsCreate a new submission/api/submissions/:idGet submission details/api/submissions/:id/statusUpdate submission statusManage participating clinical sites
/api/clinicsList all clinics/api/clinicsRegister a new clinic/api/clinics/:idGet clinic details/api/clinics/:idUpdate clinic informationCommunication between IRB and clinics
/api/messagesList messages/api/messagesSend a new message/api/messages/:idGet message thread/api/messages/:id/replyReply to a messageReport and track adverse events
/api/adverse-eventsList adverse events/api/adverse-eventsReport an adverse event/api/adverse-events/:idGet event details/api/adverse-events/:idUpdate event statusResearch data submissions from clinics
/api/data-submissionsList data submissions/api/data-submissionsSubmit research data/api/data-submissions/:idGet submission detailsAPI requests are rate limited to ensure fair usage and system stability:
# Response headers:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1609459200
Receive real-time notifications for events
Configure webhooks to receive notifications when events occur in the system:
study.created - New study createdsubmission.status_changed - Submission status updatedadverse_event.reported - New adverse event reportedmessage.received - New message receivedFor API support or questions about integration: