Getting Started
Overview of the Velaris Insurance platform APIs.
Velaris API Documentation
The Velaris Insurance platform exposes three backend APIs built with Spring Boot 4.0.3:
Partner API
Handles PMS integrations, OAuth connections, and partner onboarding. Provides endpoints for connecting with property management systems including GreenX, Guesty, IGMS, Lodgify, and Autohost.
- Base URL:
https://api.dev.velarisinsurance.com - Auth: OAuth2 / JWT
Claims API
Manages the full claims lifecycle — submission, AI-powered assessment, reservation lookups, and geocoding for property damage claims.
- Base URL:
https://api.dev.velarisinsurance.com/api/claims - Auth: JWT Bearer token
Policy API
Handles contracts, policies, renewals, invoicing, and inbound webhooks (e.g. HubSpot deal-closed). This is the core post-sale API.
- Base URL:
https://api.dev.velarisinsurance.com/api/policy - Auth: JWT Bearer token
Authentication
All APIs use JWT bearer tokens issued by the Partner API's OAuth2 flow. Include the token in the Authorization header:
Authorization: Bearer <your-jwt-token>Local Development
Each API auto-generates its OpenAPI spec via springdoc. When running locally, Swagger UI and JSON specs are available:
| API | Port | Swagger UI | OpenAPI JSON |
|---|---|---|---|
| Partner API | 9012 | http://localhost:9012/swagger-ui.html | http://localhost:9012/v3/api-docs |
| Claims API | 9020 | http://localhost:9020/swagger-ui.html | http://localhost:9020/v3/api-docs |
| Policy API | 9030 | http://localhost:9030/swagger-ui.html | http://localhost:9030/v3/api-docs |
To fetch all specs into this project for offline reference:
npm run fetch-specs