HSR Early Termination Notices API

Under the Hart-Scott-Rodino (HSR) Act, parties to certain large mergers and acquisitions must file premerger notification and wait for government review. The parties may not close their deal until the waiting period outlined in the HSR Act has passed, or the government has granted early termination of the waiting period. The FTC provides daily updates of deals that receive early termination.

- Adapted from Premerger Notification and the Merger Review Process.

More information about FTC APIs is on the FTC for Developers page.


List all HSR Early Termination Notices


GET /v0/hsr-early-termination-notices

Request


Path Parameters

(none)

Query Parameters

Parameter Type Value
api_key (string) Required (unless provided in X-Api-Key header field). A valid api.data.gov API key. You can request an API key at API Key Signup Form.
keywords (string) Optional. Filter records by keyword(s) that appear in the record title.

Multiple keywords should be separated by plus (+) characters - this will return any record whose title contains one or more of the keywords provided (an OR operation).
Example: ?keywords=Corporation+Incorporated

To match an explicit phrase, enclose it in double-quotes.
Example: ?keywords="Health%20Plan"

transaction_number (integer) Optional. Filter records by transaction number.
Example: ?transaction_number=20110728
last_updated (integer) Optional. Filter records by date/time the record was created or last updated. Filtering is based on a record's created and updated properties, and not its date property (the date the transaction was made).

For example, show all records created/updated on or after March 27, 2018:
?last_updated[value][month]=3&last_updated[value][day]=27&last_updated[value][year]=2018

Note: The [month], [day], and [year] parameters must all be included.
sort_by (string) Optional. Sort records by various criteria.
created = Sort by when record was created
changed = Sort by when record was last updated
Example: ?sort_by=created
sort_order (string) Optional. Sort direction to use with the sort_by parameter.
DESC = Sort in descending order (default)
ASC = Sort in ascending order.
Example: ?sort_by=created&sort_order=ASC
items_per_page (integer) Optional. Maximum number of records to include in JSON response. All non-empty responses include pagination metadata, which can be used to iterate over a large number of records, by sending a GET request for each page of records.
Example: ?items_per_page=10
offset (integer) Optional. Offset by a number of records, allowing a particular section of paginated results to be requested (use with the items_per_page parameter).
Example: ?offset=10

Response Parameters

Response parameters are described at the end of this page.

Response Format

All responses are in JSON format. The JSON object structure loosely adheres to the jsonapi.org spec. Possible responses:

HTTP Status CODE TYPE Description
200 OK List of HSR Early Termination Notice records (in JSON format).
400 Error Request URL does not use HTTPS (which is required for all API requests).
403 Error API key is missing or invalid. See api.data.gov General Web Service Errors for further details.
404 Error The API endpoint requested could not be found.
429 Error The rate limit has been exceeded for the API key provided.

Example

List all Early Termination Notices that include "Blockbuster" in the record title:

https://api.ftc.gov/v0/hsr-early-termination-notices?api_key=DEMO_KEY&keywords="Blockbuster"

{
    "data": [
        {
            "type": "early_termination_notice",
            "id": "128567",
            "attributes": {
                "title": "20110728: Charles W. Ergen; Blockbuster Inc. - Debtor-in-Possession",
                "transaction-number": "20110728",
                "acquired-entities": "Blockbuster Inc. - Debtor-in-Possession",
                "acquired-party": "Blockbuster Inc. - Debtor-in-Possession",
                "acquiring-party": "Charles W. Ergen",
                "date": "2011-04-08",
                "created": "2013-09-24 16:05:39",
                "updated": "2013-09-24 18:22:27",
                "tags": []
            },
            "relationships": [],
            "meta": [],
            "links": {
                "self": "https://www.ftc.gov/enforcement/premerger-notification-program/early-termination-notices/20110728"
            }
        },
        {
            "type": "early_termination_notice",
            "id": "128566",
            "attributes": {
                "title": "20110718: Carl C. Icahn; Blockbuster Inc. - Debtor-in-Possession",
                "transaction-number": "20110718",
                "acquired-entities": "Blockbuster Inc. - Debtor-in-Possession",
                "acquired-party": "Blockbuster Inc. - Debtor-in-Possession",
                "acquiring-party": "Carl C. Icahn",
                "date": "2011-04-11",
                "created": "2013-09-24 16:05:39",
                "updated": "2013-09-24 18:22:27",
                "tags": []
            },
            "relationships": [],
            "meta": [],
            "links": {
                "self": "https://www.ftc.gov/enforcement/premerger-notification-program/early-termination-notices/20110718"
            }
        }
    ],
    "meta": {
        "page": "1",
        "pages-total": "1",
        "records-this-page": "2",
        "records-total": "2"
    },
    "links": {
        "self": "https://api.ftc.gov/v0/hsr-early-termination-notices"
    }
}

Get a single HSR Early Termination Notice


GET /v0/hsr-early-termination-notices/{id}

Request


Path Parameters

Parameter Type Value
{id} (integer) Required. A valid ID for an HSR Early Termination Notice record.

Query Parameters

Parameter Type Value
api_key (string) Required (unless provided in X-Api-Key header field). A valid api.data.gov API key. You can request an API key at API Key Signup Form.

Response Parameters

Response parameters are described at the end of this page.

Response Format

All responses are in JSON format. The JSON object structure loosely adheres to the jsonapi.org spec. Possible responses:

HTTP Status CODE TYPE Description
200 OK List of HSR Early Termination Notice records (in JSON format).
400 Error Request URL does not use HTTPS (which is required for all API requests).
403 Error API key is missing or invalid. See api.data.gov General Web Service Errors for further details.
404 Error The API endpoint requested could not be found.
429 Error The rate limit has been exceeded for the API key provided.

Example

List Early Termination Notices for ID = 128567 :

https://api.ftc.gov/v0/hsr-early-termination-notices/128567?api_key=DEMO_KEY

{
    "data": [
        {
            "type": "early_termination_notice",
            "id": "128567",
            "attributes": {
                "title": "20110728: Charles W. Ergen; Blockbuster Inc. - Debtor-in-Possession",
                "transaction-number": "20110728",
                "acquired-entities": "Blockbuster Inc. - Debtor-in-Possession",
                "acquired-party": "Blockbuster Inc. - Debtor-in-Possession",
                "acquiring-party": "Charles W. Ergen",
                "date": "2011-04-08",
                "created": "2013-09-24 16:05:39",
                "updated": "2013-09-24 18:22:27",
                "tags": []
            },
            "relationships": [],
            "meta": [],
            "links": {
                "self": "https://www.ftc.gov/enforcement/premerger-notification-program/early-termination-notices/20110728"
            }
        }
    ],
    "meta": {
        "page": "1",
        "pages-total": "1",
        "records-this-page": "1",
        "records-total": "1"
    },
    "links": {
        "self": "https://api.ftc.gov/v0/hsr-early-termination-notices/128567"
    }
}

 


Response Parameters

Parameter Type Value
data (array) An array of HSR Early Termination Notice record objects.
type (string) The record type (for this endpoint, the type is "early_termination_notice").
id (string) The record ID.
attributes (object) An object containing the main data for this record.
title (string) The record title.
transaction-number (string) The transaction number that corresponds to this record.
acquired-entities (string) The entities that were acquired.
acquired-party (string) The party that was acquired.
acquiring-party (string) The acquiring party.
date (string) The date the transaction was made. Timestamp format is ISO 8601.
Example: 1997-07-16T19:20:30+01:00
created (string) The date/time the record was created. Timestamp format is ISO 8601.
updated (string) The date/time the record was last updated. Timestamp format is ISO 8601.
tags (array) An array of tags that have been applied to this record.
relationships (array) An array of other records related to this record.
meta (array) An array of metadata for this record.
links (object) An object containing links pertaining to this record.
self (url) The URL for this record.
meta (object) An object containing metadata for the request itself, including pagination data.
page (string) The page number for the list of records in this response.
pages-total (string) The total number of result pages for the request.
records-this-page (string) The number of records included in this response.
records-total (string) The total number of records found for the request.
links (object) An object containing links pertaining to the request itself.
self (url) The URL of the request.

Changelog

None (as of 4/23/18)