OpenIRIS Public API
A REST API for OpenIRIS association members: pull charges into your ERP, keep billing codes and group memberships in sync with your institutional systems, and connect lab software to your facility data.
What do you want to build?
Post charges to our ERP
Pull consolidated charges into SAP, Oracle Fusion, NetSuite or Workday as journal entries, with a dedup fence and delta sync. The primary integration surface.
Sync our directory & billing codes
Keep cost-center / WBS codes valid automatically and administer group memberships from your institutional systems.
Connect an ELN or lab tool
For software vendors serving OpenIRIS members: read resources and link experiment records to facility usage.
What is live today
| Surface | Endpoints | Status |
|---|---|---|
| Resources | GET /v1/resources, GET /v1/resources/{id} | LIVE |
| Charges | GET /v1/charges, …/{id}, …/{id}/line-items, …/{id}/exports (GET + POST) | LIVE |
| Cost centers | GET/POST /v1/cost-centers, GET/PATCH /v1/cost-centers/{id} | LIVE |
| Groups | GET /v1/groups, …/{id}, …/{id}/members (GET/POST/DELETE) | LIVE |
| Bookings, requests, webhooks, statistics… | See the roadmap | PROPOSED |
The API reference is generated from the running service and describes exactly what is implemented. The roadmap shows the full proposed surface and is open for feedback — several shipped capabilities (cost-center sync, group-member administration) came directly from member feedback on it.
In one glance
- Base URL:
https://api.openiris.io/v1 - Auth:
Authorization: Bearer oi_live_<id>_<secret>— per-organisation API keys with scopes - Format: JSON,
snake_case, ISO-8601 UTC timestamps, ISO 4217 currency codes - Errors: RFC 9457
application/problem+jsonwith a machinecodeandtrace_id - Rate limit: 600 requests/minute per key by default (headers tell you where you stand)