---
title: "What moved for a set of entities since a timestamp (filings ingested, material restatements)"
method: GET
path: "/api/v1/entities/changes"
tags: ["Entities"]
---

# What moved for a set of entities since a timestamp (filings ingested, material restatements)

`GET /api/v1/entities/changes`

## Request

- Base URL: `https://api.hub-equity.com`
- URL: `https://api.hub-equity.com/api/v1/entities/changes`
- Auth: HTTP bearer

For the given entities (a portfolio), the filings ingested since `since` and the material restatements (medium or high materiality) whose restating filing was ingested since `since`. Every event is dated by a filing. Entities not visible to the caller are dropped silently, like `/compare`.

## Query parameters

- `ids` string, required: Comma-separated entity UUIDs (at most 100).
- `since` string, date-time, required: ISO timestamp of the last visit.

## Response `200`

Successful Response

- ApiResponsePortfolioChangesResponse
  - `success` boolean, required
  - `data` PortfolioChangesResponse: What moved, for a set of entities, since ``since``.
    - `since` string, required
    - `entity_ids` string[], required
    - `new_filings` PortfolioChangeFiling[], required
      - `entity_id` string, required
      - `entity_name` string, required
      - `filing_id` string, required
      - `form_type` string, nullable
      - `fiscal_year` integer, nullable
      - `period_end` string, nullable
      - `filing_date` string, nullable
      - `ingested_at` string, required
      - `viewer_url` string, required
    - `material_restatements` PortfolioChangeRestatement[], required
      - `entity_id` string, required
      - `entity_name` string, required
      - `hub_concept_code` string, required
      - `hub_label` string, required
      - `fiscal_year` integer, nullable
      - `original_value` number, nullable
      - `restated_value` number, nullable
      - `delta_pct` number, nullable
      - `materiality` 'low' | 'medium' | 'high', required
      - `restating_filing_id` string, required
      - `restating_form_type` string, nullable
      - `restating_filing_date` string, nullable
      - `ingested_at` string, required
      - `viewer_url` string, required
    - `truncated` boolean
  - `error` ApiError: API error details.
    - `code` string, required
    - `message` string, required
    - `details` object, nullable
  - `meta` ApiMeta: API response metadata. Pagination fields (``page`` / ``per_page`` / ``total``) are populated on collection endpoints only. They are omitted from the payload on single-resource endpoints.
    - `timestamp` string, date-time
    - `request_id` string, nullable
    - `page` integer, nullable
    - `per_page` integer, nullable
    - `total` integer, nullable
  - `links` ApiLinks: HATEOAS-style pagination cursors. Host-relative path + query links for a collection page. Present on collection endpoints, ``null`` fields where a page doesn't exist (``next`` on the last page, ``prev`` on the first). The whole ``links`` object is omitted from single-resource responses (see ``ApiResponse`` serializer).
    - `self` string, nullable
    - `first` string, nullable
    - `prev` string, nullable
    - `next` string, nullable
    - `last` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/hub-equity/apis/hub-equity-api.md) · [All operations](https://skmtc.dev/hub-equity/apis/hub-equity-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hub-equity/apis/hub-equity-api/revisions/e8eeda5dc13e?raw)