> For the complete documentation index, see [llms.txt](https://help.bizmachine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.bizmachine.com/en/api-and-integrations/api-endpoints/endpoint-events.md).

# Endpoint events: business events of a company

Business events of a company: contracts, tenders, media mentions and other activity signals.

*Updated: 5 October 2026*

```
GET /{dataset}/v3/events
```

Business events of a company: won tenders, published contracts, media mentions and other activity signals. Useful for monitoring target companies or as a trigger for automated actions in your CRM.

***

### What this endpoint returns

Each event contains:

* **Subject and text**: a short description (`subject`) and the full text of the event (`text`)
* **Category**: the type of event (see the overview below)
* **Date**: when the event happened (`startedAt`) and when it was published (`publishedAt`)
* **Source**: the URL of the original source (register of contracts, media and others)
* **Entities**: the companies involved in the event (with Company ID and name)
* **Severity**: `severity` (integer; 0, 1 or 2, higher means more significant)

#### Event categories

> The available categories differ between markets. You can find the current overview in the advanced filtering in Prospector, or write to <support@bizmachine.com>.

* Contracts published in the register of contracts
* Won public tenders
* Media mentions
* Publication of financial reports (financial statements, annual reports)
* Company anniversaries
* New or ended job postings
* Management changes (arrival or departure of a managing director or an authorized officer)
* Changes of owners and statutory representatives
* New branches or a change of address

The complete list of categories is available in Prospector, in the signals section of the advanced filtering. See [Following companies: signals and automatic notifications](/en/advanced-features/company-signals-and-notifications.md). The categories are extended over time.

#### When to use this endpoint

* You are monitoring the business activity of target companies (new contracts, public contracts)
* You are looking for a sales trigger (a company has just won a contract)
* You are following changes in the ownership structure or management of target companies
* You are monitoring hiring (a company has started or stopped posting jobs)
* You are building an alert system for changes in companies

#### When to use a different endpoint

| You need                                     | Use instead    |
| -------------------------------------------- | -------------- |
| Risk signals (insolvency, enforcement)       | `risks` (v4)   |
| The overall state of the ownership structure | `owners` (v4)  |
| Regular tracking of metric trends            | `metrics` (v3) |

#### Availability

The endpoint is available for the datasets **cz, sk, pl, de**. The available signal categories differ for each dataset.

***

### Technical details

{% openapi src="/files/FGwu42o2gqsEWtcATX3u" path="/{dataset}/v3/events" method="get" %}
[api-spec.temp.json](https://247275268-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYkl7SJ14Nk0vzhVx7upl%2Fuploads%2Fgit-blob-f3abeffbb2534d765afc74352238d1f9ef6bc845%2Fapi-spec.temp.json?alt=media)
{% endopenapi %}

#### What to watch out for

* `startedAt` is the date of the event, `publishedAt` is the date of publication (it can be later), `updatedAt` is the date the record was last updated.
* `summary` is not present for all categories. For a won tender, for example, the key is missing from the response. Always check that the key exists.

***

### Instructions for AI agents

Copy this block and give it to your agent. It describes how to use the endpoint correctly.

```
## BizMachine API: events endpoint

Purpose: Returns business events for a company - won tenders, published contracts, media mentions,
and other activity signals. Useful for company monitoring and sales triggers.

When to use:
- You want to monitor business activity of target companies (new contracts, tenders)
- You need a sales trigger signal (company just won a tender, appeared in media)
- You are building an alert system for changes in target companies

When NOT to use:
- You need risk signals (insolvency, enforcement) → use risks (v4)
- You need ownership changes → use owners (v4)

URL:
  GET https://api.bizmachine.com/{dataset}/v3/events

Required:
  - Path: dataset - "cz", "sk", "pl", "de" (event categories differ per dataset)
  - Header: X-Api-Key: {api_key}

Optional:
  - Query: Company.NationalIn - filter by IČO
  - Query: Category.Code - contract-publication / tender-won / media / fin-report-publ / company-anniversary
  - Query: Company.Role - role of the company in the event
  - Query: Company.OnlyFollowed - true/false, only followed companies
  - Query: Source.Code - filter by source code
  - Query: Started.From / Started.To - date range (e.g. 2026-04-27T00:00:00Z)
  - Query: Updated.From / Updated.To - filter by update date
  - Query: Limit - default 200, max 250
  - Query: Offset - pagination

Key response fields (per item in data[]):
  data[i].data.uniqueId                - event ID
  data[i].data.subject                 - short description
  data[i].data.summary                 - summary (not present for all categories)
  data[i].data.text                    - full text
  data[i].data.url                     - source URL
  data[i].data.publishedAt             - publication timestamp (ISO 8601)
  data[i].data.startedAt               - event timestamp (ISO 8601)
  data[i].data.updatedAt               - last update timestamp (ISO 8601)
  data[i].data.categories[0].code      - event category code
  data[i].data.categories[0].name      - event category name
  data[i].data.severity                - severity integer (0, 1 or 2 - higher = more significant)
  data[i].data.entities[0].nationalIn  - IČO of company involved
  data[i].data.entities[0].name        - name of company involved
  data[i].data.entities[0].type        - entity type ("Company")

Gotchas:
  - startedAt is the event date, publishedAt is when it was published (can be later), updatedAt is when the record was last updated
  - summary is not present for all categories (e.g. tender-won, media, fin-report-publ); always check key presence

Event categories (list may change):
  - contract-publication  - government contract registry (company as supplier)
  - tender-won            - won public tender
  - media                 - media mention
  - fin-report-publ       - financial report publication (annual report, financial statements)
  - company-anniversary   - company anniversary

Typical workflow (sales trigger monitoring):
  1. events?Company.NationalIn={nationalIn}&Category.Code=tender-won → check for recent wins
  2. events?Company.NationalIn={nationalIn}&Started.From=2026-01-01 → get recent activity
```

***

Need help? Write to <support@bizmachine.com>