# List Company Events

Endpoint to return a collection of  for the given company, optionally filtered on the supplied search criteria. Event information will only be returned if the company exists in at least one of your .

Endpoint: GET /monitoring/companies/{id}/events
Version: 1.10.9
Security: bearerToken

## Query parameters:

  - `startDate` (string)
    The start date on which results are filtered.

  - `endDate` (string)
    The end date on which results are filtered.

  - `page` (integer)
    Starting page number inGlobal Monitoring is . If all items are displayed on one page this can also be left blank.

  - `pageSize` (integer)
    Number of items to return per Page.

## Path parameters:

  - `id` (string, required)
    The connectId of the company that you wish to retrieve events for.

## Response 200 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.
    Example: "23921650-c073-11ea-860f-06bc8182190e"

  - `totalCount` (number)
    The total number of events returned for the given company.
    Example: 1

  - `data` (array)

  - `data.eventId` (number)
    The unique identifier for the event.
    Example: 192873729

  - `data.companyId` (string)
    The Safe Number (Creditsafe's identifier on all Companies owned in the Creditsafe Universe) of the company that triggered the event.
    Example: "UK00004371"

  - `data.portfolioId` (number)
    The portfolio Id of the portfolio that contains the company that you requested event information for.
    Example: 589960

  - `data.ruleName` (string)
    A short description of the company event.
    Example: "Credit Limit Change"

  - `data.localEventCode` (string)
    The local event code for the event.
    Example: "CL"

  - `data.globalEventCode` (string)
    The global event code that has been mapped to the local event.
    Example: "CL"

  - `data.newValue` (string)
    Some events contain an  and  (e.g. a change in Credit Limit).
    Example: 7050000

  - `data.oldValue` (string)
    Some events contain an  and  (e.g. a change in Credit Limit).
    Example: 6100000

  - `data.eventDate` (string)
    The date that the event occurred.
    Example: "2019-03-14T22:21:50"

  - `data.createdDate` (string)
    The date that the event was created in the Creditsafe database.
    Example: "2019-03-14T22:21:50"

  - `paging` (object)
    Paging parameters.

  - `paging.size` (number,null)
    The maximum number of results returned per page.
    Example: 10

  - `paging.prev` (number,null)
    The page number of the previous page, null if there is no previous page available.

  - `paging.next` (number,null)
    The page number of the next page, null if there is no next page available.
    Example: 2

  - `paging.last` (number,null)
    The page number of the last page.
    Example: 3

## Response 400 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 401 fields (application/json):

  - `error` (string)

## Response 403 fields (application/json):

  - `message` (string)
    Example: "Access forbidden"

## Response 404 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected