---
title: "US Equities Announcements"
method: GET
path: "/v1/data/us-equity-ref/announce"
tags: ["us-equity-ref-market-events"]
---

# US Equities Announcements

`GET /v1/data/us-equity-ref/announce`

The U.S. Equities Announcements dataset provides authoritative coverage of listing-related corporate announcements for equities traded on U.S. public exchanges, with a specific focus on ticker symbol changes and delistings. For ticker change events, the dataset includes the announcement date, effective date, and both the previous and new ticker symbols. For delisting events, it captures the announcement and effective dates along with the delisting exchange. Equities traded on the OTC market are not included. Data is sourced and cross-verified from official exchange listing announcements and company SEC filings, ensuring accuracy and consistency. The dataset is updated daily starting January 2022 to reflect newly announced or effective changes

 For more details, please refer to the dataset documentation: [US Equities Announcements Guide](https://us-equity-reference-docs.s3.us-east-1.amazonaws.com/algoseek.US.Equity.Announcements.pdf).

<details>
<summary>**Advanced Filtering**</summary>

You can provide one or multiple filter expressions based on the dataset's columns to narrow down the results. For example, `StartDate.gt=2023-01-01&StartDate.lt=2023-12-31`, `Ticker=AAPL`. 

Please refer to the <a href="https://algoseek.com/docs/rest-api/tutorial/advanced-filtering">Advanced Filtering Guide</a> for the extensive reference.
</details>

## Query parameters

- `sort` string, nullable — Sorting criteria for the results. Provide a column name with optional prefix '+' for ascending order, or prefix with '-' for descending order. Multiple sorting fields may be supported depending on the dataset. If sort prefix is not provided, the ascending order is applied.
- `columns` string, nullable — A comma-separated list of columns to include in the response. Use this parameter to select only specific fields from the dataset. If not provided, all available columns will be returned.
- `offset` integer — Number of records to skip before returning results. To be used with the `limit` parameter for pagination. If not provided, defaults to 0.
- `limit` integer — Maximum number of records to return. Default and maximum values depend on the response format; see `format_limits` in the schema for details.
- `response_format` 'json' | 'csv' | 'csv_gzip' — Note the lowercase which is used for the consistency with other projects and tools

## Response `200`

JSON, CSV file, or gzip-compressed CSV file, depending on the value of `response_format` query parameter

- USEquitiesAnnouncementsDataOut
  - `data` USEquitiesAnnouncementsDataDetailsOut[], required
    - `AnnounceDate` string, date, nullable — Date when the event was announced
    - `EffectiveDate` string, date, nullable — Effective Date of the event
    - `SecId` integer, nullable — A unique identifier for a security
    - `ASID` integer, nullable — A unique identifier for a security
    - `Ticker` string, nullable — Symbol name
    - `EventType` string, nullable — The type of the event
    - `OldTicker` string, nullable — Old symbol name
    - `NewTicker` string, nullable — New symbol name
    - `DelistingExchange` string, nullable — Exchange from which symbol was delisted
  - `pagination` PaginationDetailsOut, required
    - `offset` integer — The number of records skipped to fetch the current page
    - `limit` integer, required — The maximum number of records in the current page
    - `next_offset` integer, nullable — The number of records to skip to fetch the next page

## Other responses

- `403` — Forbidden
- `422` — Validation Error
- `429` — Request rejected because the identity or team exceeded a configured monthly or per-minute usage quota. When available, the response includes rate-limit headers describing the current quota.

---

[API](https://skmtc.net/algoseek/apis/datasets-api.md) · [All operations](https://skmtc.net/algoseek/apis/datasets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/algoseek/datasets-api/revisions/1c983de099e2/schema)