# Read company events

Canonical documentation: https://veripoint.ai/api-docs/watch-events

Retrieve dated changes for a company, optionally filtered by indicator.

## Request

GET https://api.globaldatabase.com/v2/companies/{id}/watch/events

This data API uses separately licensed credentials: Authorization: Token YOUR_DATA_API_KEY. It does not accept a Veripoint workspace key.

| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | Yes | Company ID returned by a company lookup. It is not the registration number. |
| from_date | query | date | No | Optional start date, YYYY-MM-DD. |
| to_date | query | date | No | Optional end date, YYYY-MM-DD. |
| fields | query | string[] | No | Optional indicator filter. Confirm the expected query-array serialization. |
| page | query | integer | No | Page to retrieve. |
| per_page | query | integer | No | Records to return per page. No maximum is specified here in the source reference. |

## Example

```curl
curl --fail-with-body --request GET 'https://api.globaldatabase.com/v2/companies/YOUR_COMPANY_ID/watch/events?from_date=2026-09-01&to_date=2026-09-14&page=1&per_page=10' \
  --header "Authorization: Token $DATA_API_KEY" \
  --header 'Accept: application/json'
```

## Illustrative response

```json
{
  "data": [
    {
      "status": "UPDATED",
      "message": "Example company status changed.",
      "date_created": "2026-09-01T12:00:00Z",
      "event_type": "company.status"
    }
  ],
  "total_results": 1,
  "pages": 1
}
```

Illustrative excerpt. Event history uses event_type; webhook notifications use field.

- The source’s message example contains HTML. Render it as text or sanitize it; do not insert it as trusted HTML.

Machine-readable reference: https://veripoint.ai/data-openapi.json