---
title: "Fetch Businesses Events"
method: POST
path: "/v1/businesses/events"
tags: ["Businesses"]
---

# Fetch Businesses Events

`POST /v1/businesses/events`

## Request

- Base URL: `https://api.explorium.ai`
- URL: `https://api.explorium.ai/v1/businesses/events`
- Auth: one of:
  - API key in header `api_key`
  - API key in header `api_key`
- TypeScript: <https://skmtc.dev/vibeprospecting/apis/partner-service/docs/v1/businesses/events/post.ts> (a function with typed inputs; its response is checked against the schema)

Create events and fetch for businesses.

## Headers

- `tenant` string

## Request body

- BusinessesEventsRequest
  - `request_context` object, nullable
  - `entity_type` 'business' | 'prospect': The `EntityType` class is an enumeration that defines the types of entities. This enum is used to specify whether the entity is a business or a prospect. It ensures consistent handling of entity types across the application. Attributes: BUSINESS: Represents a business entity. PROSPECT: Represents a prospect entity.
  - `event_types` BusinessesEventIdentifier[], required
  - `timestamp_to` union: ISO format datetime string or date in format YYYY-MM-DD
    - string, date-time
    - string
  - `timestamp_from` union: ISO format datetime string or date in format YYYY-MM-DD
    - string, date-time
    - string
  - `business_ids` string[], required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/vibeprospecting/apis/partner-service.md) - [All operations](https://skmtc.dev/vibeprospecting/apis/partner-service/llms.txt) - [OpenAPI document](https://skmtc.dev/vibeprospecting/apis/partner-service/revisions/1699f3c803f7?raw)
