Retrieve an event

GET /api/v1/events/{event_id}

Retrieves the details of an event. You need only provide the unique event ID which you would have received in a webhook.

application/json

Body

event string

The ID of the desired event.
example

Responses

200 application/json

Returns an event object if a valid ID was provided.
Hide response attributes Show response attributes object
Events are how we communicate notable activity on an independent contractor's insurance application and policy. When an event occurs, we create a new Event object. For example, when an insurance application is started, we create an application.started event; and when a policy is issued, we create a policy.active event.

API resource state changes trigger events. The state of that resource at the time of the change is embedded in the event's data field. For example, an application.started event will contain an insurance application Session object, and a policy.active event will contain a Policy object.

Use the events endpoints to retrieve an individual event or a list of events. You can listen for events by registering your server endpoint via the 1099Policy dashboard. Our webhooks system send the Event objects directly to your registered endpoint.
- created integer(int64)
  
  Time at which the object was created. Measured in seconds since the Unix epoch.
- data object
  
  Object containing data associated with the event.
- id object
- type string
  
  Description of the event (e.g., application.started or policy.active).

GET /api/v1/events/{event_id}

curl \
 -X GET https://api.1099policy.com/api/v1/events/{event_id} \
 -H "Content-Type: application/json" \
 -d '{"event":"string"}'

Request examples

{
  "event": "string"
}

Response examples (200)

{
  "data": {
    "id": "pl_WzFRszJhoY",
    "quote": "qt_5DciVga8Kt",
    "object": "policy",
    "status": "active",
    "created": 1646818364,
    "pdf_url": "http://ten99policy.s3.amazonaws.com/1099policy-coi-sample.pdf",
    "effective_date": 1646818364,
    "expiration_date": 1678334737
  },
  "type": "policy.active"
}