Events
Everything that happens in a workspace is recorded as an event and kept for 30 days. Poll the event feed as an alternative to webhooks.
The Event object
Properties
- Name
object- Type
- 'event'
- Description
The object type.
- Name
id- Type
- string
- Description
Unique identifier, prefixed by the object type.
- Name
type- Type
- string
- Description
Type.
- Name
livemode- Type
- boolean
- Description
true for live data, false for data created with a test key.
- Name
workspaceId- Type
- string
- Description
The workspace this object belongs to.
- Name
createdAt- Type
- string
- Description
When it was created (ISO 8601).
- Name
data- Type
- object
- Description
GET/v1/events
Events of the last 30 days, newest first: what changed since…
Query parameters
- Name
limit- Type
- integer
- Description
1–100, default 20
- Name
starting_after- Type
- string
- Description
ID of the last item of the previous page
- Name
type- Type
- string
- Description
Exact type or prefix like lead.*
Request
GET
/v1/eventscurl https://core.leadveyor.com/v1/events \
-H "Authorization: Bearer {api_key}" \
-H "Leadveyor-Workspace: {workspace_id}" # account-wide keys only
Response 200
{
"object": "list",
"data": [
{
"object": "event",
"id": "evt_3fS2qHx6kwXoIIXGvOoNZYW2",
"type": "lead.outcome_recorded",
"livemode": true,
"workspaceId": "ws_Bd0Kh8oOOL8dKLzdocJ2isAj",
"createdAt": "2026-10-23T15:38:00.610Z",
"data": {
"object": {
"object": "lead",
"id": "lead_u8jzPde0IgxLd6GncfBAepfJ",
"workspaceId": "ws_Bd0Kh8oOOL8dKLzdocJ2isAj",
"livemode": true,
"sourceId": "src_IhKtJ0RlgLKOmxgJTeKdNnFR",
"inboundIds": [
"inb_IBXuDL7DxtpYlSXpfKtHF4vU"
],
"contactId": "ctc_CsMehGAkWvj7FAc9QeWJKY40",
"contact": {
"name": "Tom Baker",
"firstName": "Tom",
"lastName": "Baker",
"emails": [
"tom.baker@example.com"
],
"phones": [
"0412555777"
],
"other": [],
"company": null
},
"request": {
"summary": "Customer wants a bathroom renovation in their apartment in Q…",
"service": "Bathroom renovation"
},
"location": {
"address": null,
"city": "Queens",
"postcode": null,
"country": null
},
"language": "en",
"fields": {
"budget": {
"amount": 15000,
"currency": "USD"
},
"start_date": {
"value": "2026-12-01",
"min": "2026-12-01",
"max": "2026-12-31",
"asWritten": "next month"
},
"property_type": "apartment",
"project_type": "bathroom"
},
"evaluation": {
"confidence": 0.8,
"criteria": [
{
"id": "budget_15k",
"label": "Budget from $15k",
"type": "rule",
"result": "met",
"grade": null,
"points": 30,
"evidence": null,
"dimension": "what"
}
],
"dimensions": [
{
"id": "what",
"label": "What",
"score": 69,
"confidence": 1,
"known": [
"budget_15k"
],
"unknown": []
}
],
"decidedBy": null,
"score": 60,
"tier": "warm",
"id": "eval_uvSwMFLZDe1f8rESQedUStPK",
"profileId": "prof_R0CsTy4Qwb8DwkNhFdnXsiVp",
"profileVersion": 1,
"evaluatedAt": "2026-10-23T15:07:26.371Z"
},
"outcome": {
"status": "won",
"value": {
"amount": 14800,
"currency": "USD"
},
"reason": null,
"occurredAt": "2026-11-02T09:30:00.000Z",
"recordedAt": "2026-10-23T15:38:00.591Z",
"recordedBy": {
"type": "api_key",
"id": "key_zz63FfkCzJr4i0B3JrTAwR4y"
}
},
"state": "active",
"metadata": {},
"legacy": null,
"createdAt": "2026-10-23T15:07:26.371Z",
"updatedAt": "2026-10-23T15:38:00.591Z"
},
"previous": {
"outcome": null
}
}
}
],
"has_more": false,
"next_cursor": null
}
GET/v1/events/{id}
One event
Path parameters
- Name
id- Type
- string
- Description
Unique identifier, prefixed by the object type.
Request
GET
/v1/events/{id}curl https://core.leadveyor.com/v1/events/evt_6Gk2Pq9Tz4Lm1Wx8Rc3Vn7Bd \
-H "Authorization: Bearer {api_key}" \
-H "Leadveyor-Workspace: {workspace_id}" # account-wide keys only
Response 200
{
"object": "event",
"id": "evt_3fS2qHx6kwXoIIXGvOoNZYW2",
"type": "lead.outcome_recorded",
"livemode": true,
"workspaceId": "ws_Bd0Kh8oOOL8dKLzdocJ2isAj",
"createdAt": "2026-10-23T15:38:00.610Z",
"data": {
"object": {
"object": "lead",
"id": "lead_u8jzPde0IgxLd6GncfBAepfJ",
"workspaceId": "ws_Bd0Kh8oOOL8dKLzdocJ2isAj",
"livemode": true,
"sourceId": "src_IhKtJ0RlgLKOmxgJTeKdNnFR",
"inboundIds": [
"inb_IBXuDL7DxtpYlSXpfKtHF4vU"
],
"contactId": "ctc_CsMehGAkWvj7FAc9QeWJKY40",
"contact": {
"name": "Tom Baker",
"firstName": "Tom",
"lastName": "Baker",
"emails": [
"tom.baker@example.com"
],
"phones": [
"0412555777"
],
"other": [],
"company": null
},
"request": {
"summary": "Customer wants a bathroom renovation in their apartment in Queens, with a budget of about $15k, starting next month.",
"service": "Bathroom renovation"
},
"location": {
"address": null,
"city": "Queens",
"postcode": null,
"country": null
},
"language": "en",
"fields": {
"budget": {
"amount": 15000,
"currency": "USD"
},
"start_date": {
"value": "2026-12-01",
"min": "2026-12-01",
"max": "2026-12-31",
"asWritten": "next month"
},
"property_type": "apartment",
"project_type": "bathroom"
},
"evaluation": {
"confidence": 0.8,
"criteria": [
{
"id": "budget_15k",
"label": "Budget from $15k",
"type": "rule",
"result": "met",
"grade": null,
"points": 30,
"evidence": null,
"dimension": "what"
}
],
"dimensions": [
{
"id": "what",
"label": "What",
"score": 69,
"confidence": 1,
"known": [
"budget_15k"
],
"unknown": []
}
],
"decidedBy": null,
"score": 60,
"tier": "warm",
"id": "eval_uvSwMFLZDe1f8rESQedUStPK",
"profileId": "prof_R0CsTy4Qwb8DwkNhFdnXsiVp",
"profileVersion": 1,
"evaluatedAt": "2026-10-23T15:07:26.371Z"
},
"outcome": {
"status": "won",
"value": {
"amount": 14800,
"currency": "USD"
},
"reason": null,
"occurredAt": "2026-11-02T09:30:00.000Z",
"recordedAt": "2026-10-23T15:38:00.591Z",
"recordedBy": {
"type": "api_key",
"id": "key_zz63FfkCzJr4i0B3JrTAwR4y"
}
},
"state": "active",
"metadata": {},
"legacy": null,
"createdAt": "2026-10-23T15:07:26.371Z",
"updatedAt": "2026-10-23T15:38:00.591Z"
},
"previous": {
"outcome": null
}
}
}