POST
https://api.milda.ai/v1/companies/eventsEvents
application/json01
Description
This endpoint returns business news and event data related to companies.
Features
- Supports up to 25 companies per request
- Filter results by specific event types using the
event_typesparameter
(e.g. only retrieve investments or new partnerships) - Use
exclude_event_idsto avoid receiving (and being charged for) previously retrieved events
Event Types (12 total)
Includes but is not limited to: - Investments - New partnerships - Contracts & agreements signed - Prizes won - Other significant business activities
Data Returned
Returns 8 data fields, including: - Event sentence or description - Source website URL - Event type - Additional metadata
Credit Usage
- 1 credit per company
- Only charged if at least one event is returned
(No events = no charge) - Charges are applied per company, not per event
(e.g., 1 credit whether a company has 1 or 10 events)
Rate Limit
10 requests per second
02
Headers
nameinreqdescription
tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.
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