Developer documentation

Build with CSG Actuarial APIs

Quote Medicare Supplement, Medicare Advantage, and Part D plans from one platform. Authenticate once, then call any API with the same token.

Get started → Browse APIs

Paste into Claude, ChatGPT, or Copilot to get integration help that uses the real endpoints and specs.

Quickstart
# 1. Get a session token (valid for 8 hours)
curl -X POST \
  https://api-staging.csgactuarial.com/v1/auth.json \
  -H "Content-Type: application/json" \
  -d '{"api_key": "<your-api-key>"}'

# 2. Use it on any request
curl -G \
  https://api-staging.csgactuarial.com/v1/med_supp/quotes.json \
  -H "X-API-TOKEN: <token>" \
  -d zip5=68144 -d age=65 -d gender=F \
  -d tobacco=0 -d plan=G

Getting started

Every request requires a session token, except endpoints under open/. Service-account integrations can use the OAuth/JWT flow in the CSG Authentication docs instead.

1

Authenticate

POST /v1/auth.json with an email and password, or an api_key. Portal accounts also pass portal_name.

2

Receive a token

The response includes a token and its expires_date. Tokens stay active for eight hours.

3

Call any API

Send the token as the X-API-TOKEN header on requests to every service listed above.

Request POST /v1/auth.json
# Content-Type: application/json
{
  "api_key": "<your-api-key>",
  "portal_name": "csg_individual"
}

# Content-Type: application/x-www-form-urlencoded
api_key=<your-api-key>&portal_name=csg_individual

# Or sign in as a user instead of with an API key:
# send "email" and "password" in place of "api_key".
Response 200 OK
{
  "token": "<8-hour-session-token>",
  "expires_date": "2026-09-24T22:42:39.861010",
  "created_date": "2026-09-24T14:42:39.860960",
  "user": {
    "email": "you@example.com",
    "products": [
      { "plan_code": "admin", "state": "active" }
    ]
  }
}

Token expiration

An expired token returns 403 with Session Expired Error. Request a new token when that happens, or refresh on a schedule. Every seven hours stays safely inside the eight-hour window.

Sharing tokens

A token isn't tied to one client. Any number of clients can share it and make simultaneous requests while it's active.

Need help integrating?

Reach the CSG Actuarial team for API keys, account access, or integration questions.