> ## Documentation Index > Fetch the complete documentation index at: https://docs.leadvector.app/api-reference/llms.txt > Use this file to discover all available pages before exploring further. # List webhook events > The team's events of the last 30 days, newest first, each exactly as a delivery carries it. Filter by `type`; page with `before` (the previous page's `next`). Needs the team owner or a member with team management. ## OpenAPI ````yaml /openapi.json get /v1/events openapi: 3.1.0 info: title: LeadVector API version: '1' description: >- Find and verify business emails and mobile numbers, enrich people and companies, and run your email campaigns, mailboxes and inbox. Send your API key in the `x-api-key` header. servers: - url: https://prod.leadvector.app description: Production security: - access-key: [] tags: - name: Authentication description: Check that an API key works. - name: Lookups description: >- Find business emails and mobile numbers, verify emails, and find the person behind an email. - name: Enrichment description: The full profile of a person or a company. - name: Campaigns description: Email campaigns and their sequences. - name: Leads description: A campaign's leads. - name: Email accounts description: The mailboxes campaigns send from, and their warmup. - name: Inbox description: Replies to your campaigns, in one inbox. - name: Webhooks description: Subscribe URLs to events, and read the events sent. - name: Campaign events description: >- A campaign's lifecycle: created, launched, paused, resumed, stopped, completed, deleted. - name: Lead events description: A lead joining a campaign, replying, being labelled, finishing or failing. - name: Email events description: Each step's email to a lead, sent or failed. - name: Inbox events description: Mail the inbox receives, and the replies and forwards sent from it. - name: Email account events description: A mailbox's connection, pause, cooldown, warmup health and deletion. - name: Lookup events description: >- A single lookup’s result, in the app, the extension or the API: an email or a mobile found, an email verified, a person or a company enriched. - name: Bulk job events description: A bulk job (a file of lookups) completing or failing. - name: List events description: A contact saved to one of the team’s lists. - name: Credit events description: The team’s credits running low, or out. - name: Test event description: The event an endpoint gets when you send it a test. paths: /v1/events: get: tags: - Webhooks summary: List webhook events description: >- The team's events of the last 30 days, newest first, each exactly as a delivery carries it. Filter by `type`; page with `before` (the previous page's `next`). Needs the team owner or a member with team management. operationId: ApiV1EventsController_list parameters: - name: type required: false in: query description: Only events of this type. schema: type: string example: lead.replied - name: limit required: false in: query description: Events per page, newest first. schema: minimum: 1 maximum: 100 default: 20 type: number - name: before required: false in: query description: 'Only events older than this one: the previous page''s `next`.' schema: type: string example: evt_0192b5c4e7a87c3e9d1f2a6b4c8e0d13 responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/WebhookEventListResponseDto' '400': description: A `type`, `limit` or `before` that fails validation content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponseDto' '401': description: API_KEY_REQUIRED / INVALID_API_KEY content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponseDto' '403': description: >- INSUFFICIENT_TEAM_PERMISSION (the team owner, or a member with team management, reads events) / ACCOUNT_DEACTIVATED / TEAM_DEACTIVATED content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponseDto' '429': description: RATE_LIMIT_EXCEEDED, with a Retry-After header content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponseDto' security: - access-key: [] components: schemas: WebhookEventListResponseDto: type: object properties: success: type: boolean example: true message: type: string example: WEBHOOK_EVENTS_FETCHED data: description: Newest first, from the last 30 days. type: array items: $ref: '#/components/schemas/WebhookEventDto' next: example: evt_0192b5c4e7a87c3e9d1f2a6b4c8e0d13 description: Pass it as `before` for the next page; null on the last page. type: - string - 'null' required: - success - message - data - next ApiErrorResponseDto: type: object properties: statusCode: type: number example: 401 message: description: >- A code in capitals; the list of messages when the body fails validation; `Internal server error` for a 500. oneOf: - type: string - type: array items: type: string example: INVALID_API_KEY error: type: string description: The status's name. example: Unauthorized traceId: type: string description: Quote it when you contact support. example: 4f1c2b7e9a0d4c3b8e6f5a2d1c0b9e8f timestamp: type: string example: '2026-11-03T09:41:12.000Z' path: type: string example: /v1/find-email required: - statusCode - message - traceId - timestamp - path RateLimitErrorResponseDto: type: object properties: statusCode: type: number example: 401 message: description: The error's code. oneOf: - type: string - type: array items: type: string example: RATE_LIMIT_EXCEEDED error: type: string description: The status's name. example: Unauthorized traceId: type: string description: Quote it when you contact support. example: 4f1c2b7e9a0d4c3b8e6f5a2d1c0b9e8f timestamp: type: string example: '2026-11-03T09:41:12.000Z' path: type: string example: /v1/find-email limit: type: number description: Calls allowed per window. example: 10 windowSeconds: type: number example: 60 retryAfterSeconds: type: number description: Seconds until the next call is allowed. example: 6 required: - statusCode - message - traceId - timestamp - path - limit - windowSeconds - retryAfterSeconds WebhookEventDto: type: object properties: id: type: string example: evt_0192b5c4e7a87c3e9d1f2a6b4c8e0d13 type: type: string example: lead.replied timestamp: type: string format: date-time description: When it happened. apiVersion: type: string example: 2026-11 description: The payload version of `data`. team: $ref: '#/components/schemas/WebhookTeamRefDto' actor: description: >- The team member whose action caused it; null when nobody did (a scheduled job). anyOf: - $ref: '#/components/schemas/WebhookActorRefDto' - type: 'null' data: type: object additionalProperties: true description: >- What happened. Its shape is set by `type`: `GET /v1/webhooks/event-types` gives each type's JSON Schema. required: - id - type - timestamp - apiVersion - team - actor - data WebhookTeamRefDto: type: object properties: id: type: string format: uuid example: 019f2504-58b8-77ec-9c3f-54f5d6df733e required: - id WebhookActorRefDto: type: object properties: id: type: string format: uuid example: 019f2504-58b8-77ec-9c3f-54f5d6df7340 email: type: string format: email example: ada@example.com required: - id - email securitySchemes: access-key: type: apiKey in: header name: x-api-key description: Your API key, from the API keys page of the app. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.