Developer API
Integrate Aegis directly.
Everything in the platform is available over a REST API — request a patient study, fulfill it, and receive it under the same encryption, metering, audit, and time-boxed controls. Request access below, then read the docs.
Documentation
REST API reference
Issued per organization after verification. Keys are scoped to your role and partner relationships, exchanged for short-lived tokens, and every call is recorded in the audit trail.
Authentication
curl -X POST https://api.aegisbiocryption.com/v1/auth/token \
-H "X-Api-Key: $AEGIS_API_KEY"
# -> { "access_token": "...", "expires_in": 900 }
Base URL
https://api.aegisbiocryption.com/v1
Webhooks
transfer.delivered | first successful view |
transfer.destroyed | window end / manual |
transfer.disputed | metering mismatch |
Endpoints
| Method | Path | Role |
|---|---|---|
| POST | /requests | Consumer |
| GET | /requests | Both |
| POST | /requests/{id}/fulfill | Provider |
| POST | /requests/{id}/decline | Provider |
| GET | /inbox | Consumer |
| POST | /transfers/{id}/open | Consumer |
| GET | /audit | Both |
Example — request & receive a study
# consumer requests a specific patient
curl -X POST https://api.aegisbiocryption.com/v1/requests \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{ "providerId":"prov_123", "patient":{ "lastName":"Doe","firstName":"Jane","dob":"03/05/1971" }, "reason":"AI review" }'
# once the provider fulfills, open it -> short-lived, scoped URL + de-identified metadata
curl -X POST https://api.aegisbiocryption.com/v1/transfers/$ID/open \
-H "Authorization: Bearer $TOKEN"
API access
Apply for an API key
Keys are issued after verification (U.S. entity, signed BAA, approved partner relationship). Not self-serve.
What you get
Production-grade, audited access.
- Scoped, rotatable API keys exchanged for short-lived tokens
- Same controls as the UI — windows, metering, audit
- Webhooks for delivery, destruction, disputes
- SDKs for Python, Node, and Go
- Sandbox with synthetic data before production