developers.assurance.com Open in urlscan Pro
54.156.154.87  Public Scan

Form analysis
0 forms found in the DOM

Text Content

 * Body
 * Headers (0)

 * Body
 * Headers (1)

 * Body
 * Headers (1)

 * Body
 * Headers (14)




Public


Documentation Settings

ENVIRONMENT
Assurance APIs @ Production

LAYOUT
Double Column

LANGUAGE
cURL - cURL



Assurance APIs
Introduction
Authentication
Journey Events API
Upstream Leads API


ASSURANCE APIS

Public documentation.


AUTHENTICATION




POSTAUTHENTICATE CLIENT

https://assurance-ei.auth0.com/oauth/token

All calls to Assurance APIs are authenticated using OAuth 2.0 client credentials
grant flow.

To make a call to Assurance APIs client should first obtain Bearer token by
making a call to identity provider (assurance-ei.auth0.com) and passing along
client_id and client_secret. Identity provider will return a Bearer token in the
access_token attribute (same as auth0_token) upon successful authentication.

Client should then set Authorization header to Bearer {auth0_token} on all
subsequent API calls.

Bodyurlencoded
client_id

{{auth0_client_id}}

You application client_id provisioned by Assurance

client_secret

{{auth0_client_secret}}

You application client_secret provisioned by Assurance

audience

https://assurance.com/ei/

grant_type

client_credentials

Example Request
Authenticate Client

curl


curl --location 'https://assurance-ei.auth0.com/oauth/token' \
--data-urlencode 'client_id={{auth0_client_id}}' \
--data-urlencode 'client_secret={{auth0_client_secret}}' \
--data-urlencode 'audience=https://assurance.com/ei/' \
--data-urlencode 'grant_type=client_credentials'

Example Response
 * Body
 * Headers (0)

No response body
This request doesn't return any response body
No response headers
This request doesn't return any response headers
JOURNEY EVENTS API

A public API that allows Assurance partners to report application- and policy-
related events to Assurance.

   
 * Journey API schema
   




POSTAPPLICATION STATUS EVENT

https://assurance.com/ei/v1/journeys/:journey_id/events

The caller is required to have write_journey_events OAuth scope granted in order
to be able to make this call.

HEADERS
Authorization

Bearer {{auth0_token}}

Content-Type

application/json

PATH VARIABLES
journey_id

1

(Required)

Bodyraw (json)
json


{
    "data": {
        "caller_event_id": "769138f2-9d08-4883-b18d-b1dfee34e3f2",
        "caller_event_ts": "2024-08-03T18:09:36.059Z",
        "event_type": "application_status",
        "application_id": "fbbe6b6d-a07e-4f93-a8a3-c90d55438c56",
        "application_status": "new"
    }
}

Example Request
201 Created

curl


curl --location 'https://assurance.com/ei/v1/journeys/912/events' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "caller_event_id": "76eac190-a34b-44e4-99e4-a964048540bc",
        "caller_event_ts": "2020-01-02T03:04:05Z",
        "event_type": "application_status",
        "application_id": "710",
        "application_status": "new"
    }
}'

201 Created
Example Response
 * Body
 * Headers (1)

View More
json


{
  "data": {
    "id": 763,
    "type": "application_status",
    "attributes": {
      "caller_event_id": "5de05288-bca4-4fcd-8572-7fc49c4f3faa",
      "caller_event_ts": "2024-08-03T18:09:36.952Z",
      "application_id": "526a4d21-6993-4eb6-8d26-34ea227f30c3",
      "application_status": "new"
    }
  }
}

Content-Type

application/json


POSTUNDERWRITING REQUIREMENT EVENT

https://assurance.com/ei/v1/journeys/:journey_id/events

The caller is required to have write_journey_events OAuth scope granted in order
to be able to make this call.

HEADERS
Authorization

Bearer {{auth0_token}}

Content-Type

application/json

PATH VARIABLES
journey_id

854

(Required)

Bodyraw (json)
json


{
    "data": {
        "caller_event_id": "a58b571d-cb77-4394-91b4-8607f5fe10fc",
        "caller_event_ts": "2024-08-03T18:09:36.060Z",
        "event_type": "underwriting_required",
        "policy_id": "345",
        "requirement_name": "exam",
        "requirement_status": "ordered",
        "requirement_ts": "2024-08-03T18:09:36.060Z"
    }
}

Example Request
201 Created

View More
curl


curl --location 'https://assurance.com/ei/v1/journeys/693/events' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "caller_event_id": "123",
        "caller_event_ts": "2020-01-02T03:04:05Z",
        "event_type": "underwriting_required",
        "policy_id": "345",
        "requirement_name": "exam",
        "requirement_status": "ordered",
        "requirement_ts": "2020-01-02T03:04:05Z"
    }
}'

201 Created
Example Response
 * Body
 * Headers (1)

View More
json


{
  "data": {
    "id": 935,
    "type": "underwriting_required",
    "attributes": {
      "caller_event_id": "3f0708aa-3b7a-43ae-94aa-7141ab68476e",
      "caller_event_ts": "2024-08-03T18:09:36.952Z",
      "policy_id": "345",
      "requirement_status": "ordered",
      "requirement_name": "exam",
      "requirement_ts": "2020-01-01T19:04:05.000-08:00"
    }
  }
}

Content-Type

application/json


POSTUNDERWRITING DECISION EVENT

https://assurance.com/ei/v1/journeys/:journey_id/events

The caller is required to have write_journey_events OAuth scope granted in order
to be able to make this call.

HEADERS
Authorization

Bearer {{auth0_token}}

Content-Type

application/json

PATH VARIABLES
journey_id

910

(Required)

Bodyraw (json)
json


{
    "data": {
        "caller_event_id": "123",
        "caller_event_ts": "2020-01-02T03:04:05Z",
        "event_type": "underwriting_decision",
        "policy_id": "345",
        "decision_details": "free form text"
    }
}

Example Request
201 Created

curl


curl --location 'https://assurance.com/ei/v1/journeys/149/events' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "caller_event_id": "123",
        "caller_event_ts": "2020-01-02T03:04:05Z",
        "event_type": "underwriting_decision",
        "policy_id": "345",
        "decision_details": "free form text"
    }
}'

201 Created
Example Response
 * Body
 * Headers (14)

View More
json


{
  "data": {
    "id": 678,
    "type": "underwriting_decision",
    "attributes": {
      "caller_event_id": "628ad6eb-3baf-466f-8e44-7bea9c4bcdd7",
      "caller_event_ts": "2024-08-03T18:09:36.952Z",
      "policy_id": "345",
      "decision_details": "free form text",
      "decision_reason": null,
      "premium_amount": null,
      "modified_premium_amount": null,
      "max_face_value": null
    }
  }
}

Date

Fri, 27 Mar 2020 23:23:32 GMT

Content-Type

application/json

Transfer-Encoding

chunked

Connection

keep-alive

ETag

W/"be10ed25d2898a07e29a21e34657fabb"

Cache-Control

max-age=0, private, must-revalidate

X-Request-Id

516bbbfe-da66-423a-8693-e76b1aab04b4

X-Runtime

0.439941

Vary

Accept-Encoding, Origin

Content-Encoding

gzip

Strict-Transport-Security

max-age=31536000; includeSubDomains

X-Content-Type-Options

nosniff

X-Xss-Protection

1; mode=block

Referrer-Policy

same-origin