API Documentation
Welcome to the IFRS 17 API Documentation
Introduction
The IFRS 17 API documentation is designed for developers to:
- Perform disclosures calculations
- Calculate risk adjustments
- Handle CSM amortization and PAA eligibility
- Calculate discount component
Onboarding
- New organization registration is done by an ACTSERV administrator.
- The new organization's developer creates a user account on our IFRS17 platform and verifies their email.
- ACTSERV administrator assigns an organization and authorizes the developer user.
- The organization developer navigates onto our platform, on the administrator panel and generates an API KEY.
Authentication
All protected API requests require an API KEY as the Bearer token.
Example:
curl --header "Authorization: Bearer <API-KEY-goes-here>"
Base URL
All API endpoints are accessed via the following base URL:
https://api.i17.actserv-africa.com/api/v2.
Interactive testing can be done via IFRS-17 API Testing.
Parameters
All parameters are required unless stated as optional.
Error Handling
The API uses standard HTTP status codes with descriptive messages.
Example:
{
"code": 401,
"msg": "Not authorized!"
}
API Features
Explore the core functionalities of our API:
- Disclosures: Generate financial disclosures from Group of Contracts data (GoC).
- Discount Component: Handle discount components.
- Risk Adjustment: Perform risk adjustments on claims data.
- Contractual Service Margin: Obtain CSM amortization & PAA eligibility from policy data.