Skip to main content

API Reference

Welcome to OneAssure's API documentation. Our APIs are designed to help you integrate insurance services seamlessly into your applications.

Base URL​

Please contact our team to get the base URL for your environment.

API Versioning​

OneAssure APIs use versioning to ensure backward compatibility while allowing for new features and improvements.

Version Format​

Path Versioning: All API endpoints include a major version prefix in the URL path:

/v{major}/path/to/resource

Example: /v1/auth/token

Authentication​

All OneAssure APIs require authentication using a Bearer token. To authenticate:

  1. Obtain API Credentials: Contact the OneAssure team to receive your unique client_id and client_secret.
  2. Generate a Token: Use the Token API to exchange your credentials for a temporary access token.
  3. Use the Token: Include the token in the Authorization header of all API requests.
Authorization: Bearer YOUR_ACCESS_TOKEN

Tokens are valid for 1 Hour and must be regenerated when expired. For security best practices and detailed authentication instructions, see our Authentication Guide.

Available APIs​

Token​

Authentication and token management for secure API access.

Redirection​

Redirect users into the OneAssure hosted health journey using a session token.

Embedded APIs​

Direct integration of affinity insurance services into your applications.

Core APIs​

APIs for managing core insurance journeys.

Need Help?​

Contact our developer support team for assistance with your integration.