POST
https://api.milda.ai/v1/companies/eventsCompany Events
application/json01
Description
This endpoint returns business news and event data related to companies.
Features
- Up to 25 company IDs and 25 URLs per request
- Filter results by event type with the
event_typesparameter (e.g. onlyFunding & investmentandPartnerships) - Use
exclude_event_idsto leave out events you already have
Event Types
There are 11:
- Contracts & agreements
- Financials
- Funding & investment
- Hiring
- Intellectual property
- Licensing & authorisation
- Partnerships
- Prizes & awards
- Standards
- Challenges
- Other
Data Returned
Each event has its ID, the company ID, the date, its event types, the sentence that reports it with surrounding context, the amount in euro (where one is stated), and the source URL.
Unknown company IDs and malformed URLs return no events; check them with Get Company Statuses first.
Credit Usage
- 1 credit per company that has at least one event in the response (No events = no charge)
- Charges are per company, not per event (1 credit whether a company has 1 or 10 events)
- Excluding events with
exclude_event_idsonly avoids the charge when it removes all of that company's events
Rate Limit
10 requests per second
02
Headers
nameinreqdescription
tokenheaderone ofYour API token, sent as "token: YOUR_API_TOKEN". Send this or Authorization.
Authorizationheaderone ofThe same token in the standard form, sent as "Authorization: Bearer YOUR_API_TOKEN" (the word Bearer, a space, then your token). Send this or token.
03
Request body
EventsDataRequestItemEventsDataRequestItemtypereq4 fields
company_idsstring[]—List of up to 25 unique company identifiers to request event data for.
urlsstring[]—List of up to 25 company website URLs or domain names to identify companies.
event_typesEventType[]—List of event types to include in the results. If empty, all event types will be returned.
exclude_event_idsstring[] | null—Optional list of event IDs to exclude from the results (up to 100,000 entries).
04
Responses
200 Successful Response422 Validation Error
Returns a JSON array. Each item:
CompanyEventtype8 fields
event_idstringUnique identifier for the event.
company_idstring | nullUnique identifier of the company associated with the event, if resolved.
event_datestring | nullDate when the event occurred or was reported, in ISO 8601 format (YYYY-MM-DD).
event_typesEventType[] | nullCategories of the event, e.g. 'Funding & investment' or 'Hiring'.
sentencestring | nullShort sentence summarizing the event, typically extracted from the source.
contextstring | nullOptional sentence providing background or context related to the event.
amount_eurointeger | nullEstimated amount in euros associated with the event (e.g., funding round).
urlstring | nullSource URL or reference for the event (e.g., news article, press release).