developers.assurance.com Open in urlscan Pro
52.206.105.62  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": "de3673fa-6aa0-4f33-919b-69b4f3240e9f",
        "caller_event_ts": "2023-04-03T12:35:22.040Z",
        "event_type": "application_status",
        "application_id": "52f70506-6ff5-41cc-8eca-0884e1ee9de7",
        "application_status": "new"
    }
}

Example Request
201 Created

curl


curl --location 'https://assurance.com/ei/v1/journeys/283/events' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "caller_event_id": "6d93a601-b071-4931-ae07-eb334279f239",
        "caller_event_ts": "2020-01-02T03:04:05Z",
        "event_type": "application_status",
        "application_id": "83",
        "application_status": "new"
    }
}'

Example Response
 * Body
 * Headers (1)

View More
javascript


{
  "data": {
    "id": 186,
    "type": "application_status",
    "attributes": {
      "caller_event_id": "a2a20176-ca30-46a2-8e12-551cc3497ba0",
      "caller_event_ts": "2023-04-03T12:35:22.065Z",
      "application_id": "bf4f8d40-4938-47b5-94bb-5c6224557bb3",
      "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

445

(Required)

Bodyraw (json)
json


{
    "data": {
        "caller_event_id": "1a3e5823-cd95-4de7-a7f9-2146c07a784b",
        "caller_event_ts": "2023-04-03T12:35:22.041Z",
        "event_type": "underwriting_required",
        "policy_id": "345",
        "requirement_name": "exam",
        "requirement_status": "ordered",
        "requirement_ts": "2023-04-03T12:35:22.041Z"
    }
}

Example Request
201 Created

View More
curl


curl --location 'https://assurance.com/ei/v1/journeys/66/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"
    }
}'

Example Response
 * Body
 * Headers (1)

View More
javascript


{
  "data": {
    "id": 31,
    "type": "underwriting_required",
    "attributes": {
      "caller_event_id": "ca79bd96-9889-48be-bee8-655ae628313b",
      "caller_event_ts": "2023-04-03T12:35:22.065Z",
      "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

716

(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/682/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"
    }
}'

Example Response
 * Body
 * Headers (14)

View More
javascript


{
  "data": {
    "id": 678,
    "type": "underwriting_decision",
    "attributes": {
      "caller_event_id": "f886e48c-58f2-46a3-9942-43df156ed9b8",
      "caller_event_ts": "2023-04-03T12:35:22.065Z",
      "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