Submission Confirmation API

The Submission Confirmation API sends notifications when an enrollment application is submitted through HealthSherpa to the Carrier.

On-exchange notifications provide less detail than off-exchange plans due to regulatory restrictions. Below are links to hop to documentation for On-Exchange and Off-Exchange plans:

• On-Exchange Plans

• Off-Exchange Plans

On-Exchange Plans

post

Body

transaction_idstringOptional

Unique identifier for the transaction (confirmation ID)

Example: 123456789

event_typestring · enumOptional

Type of event that triggered the webhook

Example: submissionPossible values:

event_timestampstring · date-timeOptional

Timestamp when the application was submitted

Example: 2025-05-01T20:35:42.843Z

external_idstringOptional

External identifier for the enrollment lead

Example: f7a8b9c0d1e2f3g4h5i6j7k8l9m0n1o2

submitter_npnstringOptional

National Producer Number of the agent who submitted the application

Example: 17169718

npn_used_at_submissionstringOptional

NPN recorded at the time of submission

Example: 17169718

Responses

200

Successful response

post

HTTPcURLJavaScriptPython

POST /your-endpoint-url HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 213

{
  "transaction_id": "123456789",
  "event_type": "submission",
  "event_timestamp": "2025-05-01T20:35:42.843Z",
  "external_id": "f7a8b9c0d1e2f3g4h5i6j7k8l9m0n1o2",
  "submitter_npn": "17169718",
  "npn_used_at_submission": "17169718"
}

200

Successful response

No content

Off-Exchange Plans

post

Body

transaction_idstringOptional

Unique identifier for the transaction (confirmation ID)

Example: 123456789

application_idstringOptional

Canonical identifier for the off-exchange application

Example: HSA000000000

policy_statusstring · enumOptional

Current status of the active health policy

Example: pending_effectuationPossible values:

event_typestring · enumOptional

Type of event that triggered the webhook

Example: submissionPossible values:

event_timestampstringOptional

Date when the application was last submitted (MM/DD/YYYY format)

Example: 07/01/2025

external_idstringOptional

External identifier for the enrollment lead

Example: f7a8b9c0d1e2f3g4h5i6j7k8l9m0n1o2

policy_aor_npnstringOptional

National Producer Number of the Agent of Record on the policy

Example: 1234567890

submitter_npnstringOptional

National Producer Number of the agent who submitted the application

Example: 17169718

npn_used_at_submissionstringOptional

NPN recorded at the time of submission

Example: 17169718

issuer_hios_idstringOptional

HIOS ID of the insurance issuer

Example: 12345

Responses

200

Successful response

post

HTTPcURLJavaScriptPython

POST /your-endpoint-url HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 858

{
  "transaction_id": "123456789",
  "application_id": "HSA000000000",
  "policy_status": "pending_effectuation",
  "event_type": "submission",
  "event_timestamp": "07/01/2025",
  "external_id": "f7a8b9c0d1e2f3g4h5i6j7k8l9m0n1o2",
  "policy_aor_npn": "1234567890",
  "submitter_npn": "17169718",
  "npn_used_at_submission": "17169718",
  "issuer_hios_id": "12345",
  "members": [
    {
      "member_id": "HSM000000000",
      "first_name": "John",
      "last_name": "Doe",
      "date_of_birth": "05/10/1980"
    }
  ],
  "policies": [
    {
      "policy_id": "HSP000000000",
      "effective_date": "08/01/2025",
      "expiration_date": "12/31/2025",
      "status": "pending_effectuation",
      "plan_hios_id": "12345LA012345",
      "gross_premium": 750.25,
      "members": [
        {
          "member_id": "HSM000000000",
          "effective_date": "08/01/2025",
          "removed_date": null
        }
      ],
      "agent_of_record": {
        "npn": "1234567890",
        "first_name": "Tom",
        "last_name": "Doe",
        "state_license_number": "GA123456",
        "email": "[email protected]"
      }
    }
  ]
}

200

Successful response

No content