List programs available to the caller

GET

/v1/programs

Returns the insurance programs the calling tenant has access to. Filter by product type or active status. Returns a lightweight summary object per program; use GET /v1/programs/{programId} for full detail including endorsements, options, and terms.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Programs fetched successfully.

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🔴500InternalServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/programs?productType=TI&isActive=true' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "success": true,
    "data": [
        {
            "id": "c70f27d4-0f63-443c-b210-5dd3c0dd52d5",
            "code": "INF-ELITE-X",
            "name": "Infinite Risk Travel Elite X",
            "productType": "TI",
            "carrier": {
                "id": "a1b2c3d4-0000-0000-0000-000000000001",
                "name": "Crum & Forster SPC"
            },
            "ratingMethod": "factor",
            "isActive": true
        },
        {
            "id": "d81f38e5-1f74-554d-c321-6ee4d1ee63e6",
            "code": "COTERIE-BOP",
            "name": "Coterie Business Owners Policy",
            "productType": "BOP",
            "carrier": {
                "id": "b2c3d4e5-0000-0000-0000-000000000002",
                "name": "Coterie"
            },
            "ratingMethod": "external",
            "isActive": true
        }
    ]
}

Modified at 2026-05-05 22:52:44

API health status

Get program by ID