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/events
curl 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
    }
  }
}

Was this page helpful?