--- title: "Get Headlines" url: "https://console.9fin.com/apis/news-api-v2/versions/d8d91da6-77d3-48db-a023-e71b20cfd311/operations/get_headlines_v2_news_headlines_get" --- > Full API specification: https://console.9fin.com/apis/news-api-v2/versions/d8d91da6-77d3-48db-a023-e71b20cfd311.md # Get Headlines `GET` `/v2/news/headlines` Operation ID: `get_headlines_v2_news_headlines_get` Get news headlines, excluding any private items. ## Query parameters - `cursor` (optional) - Opaque pagination cursor from a previous response's `next_cursor`; omit for the first page. Example: `MjAyNi0wNy0xN1QwMTozNTozNC40ODo0MWY0OThhNy1jOTliLTQ5NmItOGViMi1lNzIzYjdlZDUzYTM=` - `limit` (integer, optional) - Maximum number of headlines to return per page. It is possible to receive fewer than the requested number of items. - `content_tags__in` (optional) - Comma-separated list of content tags to OR-filter on (maximum 5). Example: `9fin-All, 9fin-Primary`
Show example of valid content tags - `9fin-9Questions` - `9fin-ABS` - `9fin-All` - `9fin-Announcement` - `9fin-Asset Based Finance` - `9fin-Bankruptcy QuickTake` - `9fin-Blessed to be Stressed` - `9fin-Bond Legal QuickTake` - `9fin-CLO` - `9fin-CLO Primary` - `9fin-Cloud 9fin` - `9fin-Credit QuickTake` - `9fin-Deal Predictions` - `9fin-Deal Preview` - `9fin-Distressed` - `9fin-Distressed Pitch List` - `9fin-Editorial` - `9fin-Educational` - `9fin-ESG` - `9fin-ESG QuickTake` - `9fin-Excess Spread` - `9fin-Feature` - `9fin-Frameworks` - `9fin-Friday Workout` - `9fin-Fundraising` - `9fin-Investment Grade` - `9fin-Legal Research` - `9fin-Liability Management (LME)` - `9fin-Loan Credit QuickTake` - `9fin-Loan Legal QuickTake` - `9fin-LP Wrap` - `9fin-Morning Coffee` - `9fin-Origination` - `9fin-People Moves` - `9fin-Primary` - `9fin-Private Credit` - `9fin-Restructuring QuickTake` - `9fin-Secondary` - `9fin-SRT` - `9fin-Stressed QuickTake` - `9fin-Sustainable Junk` - `9fin-Taking the Credit` - `9fin-The Default Notice` - `9fin-Top of the Flops` - `9fin-Trend Reports` - `9fin-Under the hood` - `9fin-Unicrunch` - `9fin-Watching the Defectives` - `9fin-Winding Up` - `9fin-Wrap` - `ABF Deal Update` - `Calendar` - `CLO Deal Update` - `Deal` - `Deal Updates` - `ESG` - `Loan Radar News` - `New ABF Deal` - `New CLO Deal` - `News` - `Press Release` - `Ratings` - `Regulatory Filing` - `Results`
- `source_type` (optional) - Filter by one of the following `9fin`, `third-party`, `all`. Defaults to `all` if omitted. `9fin` returns only 9fin-authored content, `third-party` returns content sourced from third parties, and `all` returns both. - `nf_ids__in` (optional) - Comma-separated list of 9fin entity IDs to OR-filter on (maximum 10). An item is included if it references any of the supplied entitiy IDs. Example: `nf_ent_9be02202196b4567b40fcd412b14ccfe, nf_ent_300cf4bc9698484f880b4a678c8eccf5` - `entity_country_code` (optional) - Filter by the country code of the main entity, as a two-letter ISO 3166-1 alpha-2 code.
Show all accepted codes - `AD` — Andorra - `AE` — United Arab Emirates - `AF` — Afghanistan - `AG` — Antigua and Barbuda - `AI` — Anguilla - `AL` — Albania - `AM` — Armenia - `AO` — Angola - `AQ` — Antarctica - `AR` — Argentina - `AS` — American Samoa - `AT` — Austria - `AU` — Australia - `AW` — Aruba - `AX` — Åland Islands - `AZ` — Azerbaijan - `BA` — Bosnia and Herzegovina - `BB` — Barbados - `BD` — Bangladesh - `BE` — Belgium - `BF` — Burkina Faso - `BG` — Bulgaria - `BH` — Bahrain - `BI` — Burundi - `BJ` — Benin - `BL` — Saint Barthélemy - `BM` — Bermuda - `BN` — Brunei Darussalam - `BO` — Bolivia, Plurinational State of - `BQ` — Bonaire, Sint Eustatius and Saba - `BR` — Brazil - `BS` — Bahamas - `BT` — Bhutan - `BV` — Bouvet Island - `BW` — Botswana - `BY` — Belarus - `BZ` — Belize - `CA` — Canada - `CC` — Cocos (Keeling) Islands - `CD` — Congo, The Democratic Republic of the - `CF` — Central African Republic - `CG` — Congo - `CH` — Switzerland - `CI` — Côte d'Ivoire - `CK` — Cook Islands - `CL` — Chile - `CM` — Cameroon - `CN` — China - `CO` — Colombia - `CR` — Costa Rica - `CU` — Cuba - `CV` — Cabo Verde - `CW` — Curaçao - `CX` — Christmas Island - `CY` — Cyprus - `CZ` — Czechia - `DE` — Germany - `DJ` — Djibouti - `DK` — Denmark - `DM` — Dominica - `DO` — Dominican Republic - `DZ` — Algeria - `EC` — Ecuador - `EE` — Estonia - `EG` — Egypt - `EH` — Western Sahara - `ER` — Eritrea - `ES` — Spain - `ET` — Ethiopia - `FI` — Finland - `FJ` — Fiji - `FK` — Falkland Islands (Malvinas) - `FM` — Micronesia, Federated States of - `FO` — Faroe Islands - `FR` — France - `GA` — Gabon - `GB` — United Kingdom - `GD` — Grenada - `GE` — Georgia - `GF` — French Guiana - `GG` — Guernsey - `GH` — Ghana - `GI` — Gibraltar - `GL` — Greenland - `GM` — Gambia - `GN` — Guinea - `GP` — Guadeloupe - `GQ` — Equatorial Guinea - `GR` — Greece - `GS` — South Georgia and the South Sandwich Islands - `GT` — Guatemala - `GU` — Guam - `GW` — Guinea-Bissau - `GY` — Guyana - `HK` — Hong Kong - `HM` — Heard Island and McDonald Islands - `HN` — Honduras - `HR` — Croatia - `HT` — Haiti - `HU` — Hungary - `ID` — Indonesia - `IE` — Ireland - `IL` — Israel - `IM` — Isle of Man - `IN` — India - `IO` — British Indian Ocean Territory - `IQ` — Iraq - `IR` — Iran, Islamic Republic of - `IS` — Iceland - `IT` — Italy - `JE` — Jersey - `JM` — Jamaica - `JO` — Jordan - `JP` — Japan - `KE` — Kenya - `KG` — Kyrgyzstan - `KH` — Cambodia - `KI` — Kiribati - `KM` — Comoros - `KN` — Saint Kitts and Nevis - `KP` — Korea, Democratic People's Republic of - `KR` — Korea, Republic of - `KW` — Kuwait - `KY` — Cayman Islands - `KZ` — Kazakhstan - `LA` — Lao People's Democratic Republic - `LB` — Lebanon - `LC` — Saint Lucia - `LI` — Liechtenstein - `LK` — Sri Lanka - `LR` — Liberia - `LS` — Lesotho - `LT` — Lithuania - `LU` — Luxembourg - `LV` — Latvia - `LY` — Libya - `MA` — Morocco - `MC` — Monaco - `MD` — Moldova, Republic of - `ME` — Montenegro - `MF` — Saint Martin (French part) - `MG` — Madagascar - `MH` — Marshall Islands - `MK` — North Macedonia - `ML` — Mali - `MM` — Myanmar - `MN` — Mongolia - `MO` — Macao - `MP` — Northern Mariana Islands - `MQ` — Martinique - `MR` — Mauritania - `MS` — Montserrat - `MT` — Malta - `MU` — Mauritius - `MV` — Maldives - `MW` — Malawi - `MX` — Mexico - `MY` — Malaysia - `MZ` — Mozambique - `NA` — Namibia - `NC` — New Caledonia - `NE` — Niger - `NF` — Norfolk Island - `NG` — Nigeria - `NI` — Nicaragua - `NL` — Netherlands - `NO` — Norway - `NP` — Nepal - `NR` — Nauru - `NU` — Niue - `NZ` — New Zealand - `OM` — Oman - `PA` — Panama - `PE` — Peru - `PF` — French Polynesia - `PG` — Papua New Guinea - `PH` — Philippines - `PK` — Pakistan - `PL` — Poland - `PM` — Saint Pierre and Miquelon - `PN` — Pitcairn - `PR` — Puerto Rico - `PS` — Palestine, State of - `PT` — Portugal - `PW` — Palau - `PY` — Paraguay - `QA` — Qatar - `RE` — Réunion - `RO` — Romania - `RS` — Serbia - `RU` — Russian Federation - `RW` — Rwanda - `SA` — Saudi Arabia - `SB` — Solomon Islands - `SC` — Seychelles - `SD` — Sudan - `SE` — Sweden - `SG` — Singapore - `SH` — Saint Helena, Ascension and Tristan da Cunha - `SI` — Slovenia - `SJ` — Svalbard and Jan Mayen - `SK` — Slovakia - `SL` — Sierra Leone - `SM` — San Marino - `SN` — Senegal - `SO` — Somalia - `SR` — Suriname - `SS` — South Sudan - `ST` — Sao Tome and Principe - `SV` — El Salvador - `SX` — Sint Maarten (Dutch part) - `SY` — Syrian Arab Republic - `SZ` — Eswatini - `TC` — Turks and Caicos Islands - `TD` — Chad - `TF` — French Southern Territories - `TG` — Togo - `TH` — Thailand - `TJ` — Tajikistan - `TK` — Tokelau - `TL` — Timor-Leste - `TM` — Turkmenistan - `TN` — Tunisia - `TO` — Tonga - `TR` — Türkiye - `TT` — Trinidad and Tobago - `TV` — Tuvalu - `TW` — Taiwan, Province of China - `TZ` — Tanzania, United Republic of - `UA` — Ukraine - `UG` — Uganda - `UM` — United States Minor Outlying Islands - `US` — United States - `UY` — Uruguay - `UZ` — Uzbekistan - `VA` — Holy See (Vatican City State) - `VC` — Saint Vincent and the Grenadines - `VE` — Venezuela, Bolivarian Republic of - `VG` — Virgin Islands, British - `VI` — Virgin Islands, U.S. - `VN` — Viet Nam - `VU` — Vanuatu - `WF` — Wallis and Futuna - `WS` — Samoa - `YE` — Yemen - `YT` — Mayotte - `ZA` — South Africa - `ZM` — Zambia - `ZW` — Zimbabwe
- `industries__in` (optional) - Comma-separated list of industries to OR-filter on (maximum 5). An item is included if it references any of the supplied industries. Example: `Banks, Software & Services`
Show all accepted industries - `Aerospace / Defense` - `Alcoholic Beverage` - `Apparel` - `Automotive Manufacturer` - `Automotive Supplier` - `Banks` - `Chemical` - `Commercial & Professional Services` - `Communications Infrastructure` - `Construction and Engineering` - `Construction Materials` - `Consumer Durables` - `Consumer Services` - `Diversified Financials` - `Diversified Technology` - `Electric Utilities and Power` - `Energy, Oilfield Services` - `Energy, Oil & Gas` - `Environmental Services and Waste Management Cos.` - `Equipment Rental` - `Food Products` - `Gaming` - `Health Care Equipment & Services` - `Homebuilding And Property Development` - `Hotels, Resorts & Cruise Lines` - `Independent Power and Renewable Electricity Producers` - `Insurance` - `Manufacturing` - `Media Industry` - `Mining` - `Multi-Utilities and Power` - `Packaging` - `Paper and Forest Products` - `Pharmaceuticals, Biotechnology & Life Sciences` - `Protein and Agriculture` - `REITs and Other Commercial Property Firms` - `Restaurants` - `Retailing` - `Soft Beverage` - `Software & Services` - `Steel` - `Telecommunications` - `Transportation and Logistics` - `Water Utilities`
- `region` (optional) - Filter by the coverage region (case-insensitive). - `since` (optional) - Only return headlines published at or after this instant. ISO 8601 datetime; if a date-only value is supplied, it is interpreted as midnight UTC. If no timezone is provided, UTC is assumed. Examples: `2026-01-01T00:00:00Z`, `2026-01-01T15:35:45`, `2026-01-01` - `until` (optional) - Only return headlines published at or before this instant. ISO 8601 datetime; if a date-only value is supplied, it is interpreted as midnight UTC. If no timezone is provided, UTC is assumed. Must be strictly after `since` when both are supplied. Examples: `2026-02-03T00:00:00Z`, `2026-01-01T15:35:45`, `2026-01-01` ## Responses - `200` - Successful Response - `400` - `invalid_cursor`, `invalid_content_tag`, `invalid_nf_ids`, `invalid_date_range`, - `422` - Validation Error - `500` - An unexpected error occurred ## OpenAPI definition ```yaml openapi: 3.1.0 info: title: 9fin News & Content API - v2 version: 0.3.38 servers: - url: https://api.9fin.com description: prod paths: /v2/news/headlines: get: tags: [] summary: Get Headlines description: Get news headlines, excluding any private items. operationId: get_headlines_v2_news_headlines_get parameters: - name: cursor in: query required: false schema: anyOf: - type: string - type: "null" title: Cursor description: |- Opaque pagination cursor from a previous response's `next_cursor`; omit for the first page. Example: `MjAyNi0wNy0xN1QwMTozNTozNC40ODo0MWY0OThhNy1jOTliLTQ5NmItOGViMi1lNzIzYjdlZDUzYTM=` default: null description: |- Opaque pagination cursor from a previous response's `next_cursor`; omit for the first page. Example: `MjAyNi0wNy0xN1QwMTozNTozNC40ODo0MWY0OThhNy1jOTliLTQ5NmItOGViMi1lNzIzYjdlZDUzYTM=` - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 title: Limit description: Maximum number of headlines to return per page. It is possible to receive fewer than the requested number of items. examples: - 50 - 100 - 200 default: 50 description: Maximum number of headlines to return per page. It is possible to receive fewer than the requested number of items. - name: content_tags__in in: query required: false schema: anyOf: - type: string - type: "null" title: Content tags description: >- Comma-separated list of content tags to OR-filter on (maximum 5). Example: `9fin-All, 9fin-Primary`
Show example of valid content tags - `9fin-9Questions` - `9fin-ABS` - `9fin-All` - `9fin-Announcement` - `9fin-Asset Based Finance` - `9fin-Bankruptcy QuickTake` - `9fin-Blessed to be Stressed` - `9fin-Bond Legal QuickTake` - `9fin-CLO` - `9fin-CLO Primary` - `9fin-Cloud 9fin` - `9fin-Credit QuickTake` - `9fin-Deal Predictions` - `9fin-Deal Preview` - `9fin-Distressed` - `9fin-Distressed Pitch List` - `9fin-Editorial` - `9fin-Educational` - `9fin-ESG` - `9fin-ESG QuickTake` - `9fin-Excess Spread` - `9fin-Feature` - `9fin-Frameworks` - `9fin-Friday Workout` - `9fin-Fundraising` - `9fin-Investment Grade` - `9fin-Legal Research` - `9fin-Liability Management (LME)` - `9fin-Loan Credit QuickTake` - `9fin-Loan Legal QuickTake` - `9fin-LP Wrap` - `9fin-Morning Coffee` - `9fin-Origination` - `9fin-People Moves` - `9fin-Primary` - `9fin-Private Credit` - `9fin-Restructuring QuickTake` - `9fin-Secondary` - `9fin-SRT` - `9fin-Stressed QuickTake` - `9fin-Sustainable Junk` - `9fin-Taking the Credit` - `9fin-The Default Notice` - `9fin-Top of the Flops` - `9fin-Trend Reports` - `9fin-Under the hood` - `9fin-Unicrunch` - `9fin-Watching the Defectives` - `9fin-Winding Up` - `9fin-Wrap` - `ABF Deal Update` - `Calendar` - `CLO Deal Update` - `Deal` - `Deal Updates` - `ESG` - `Loan Radar News` - `New ABF Deal` - `New CLO Deal` - `News` - `Press Release` - `Ratings` - `Regulatory Filing` - `Results`
default: null description: >- Comma-separated list of content tags to OR-filter on (maximum 5). Example: `9fin-All, 9fin-Primary`
Show example of valid content tags - `9fin-9Questions` - `9fin-ABS` - `9fin-All` - `9fin-Announcement` - `9fin-Asset Based Finance` - `9fin-Bankruptcy QuickTake` - `9fin-Blessed to be Stressed` - `9fin-Bond Legal QuickTake` - `9fin-CLO` - `9fin-CLO Primary` - `9fin-Cloud 9fin` - `9fin-Credit QuickTake` - `9fin-Deal Predictions` - `9fin-Deal Preview` - `9fin-Distressed` - `9fin-Distressed Pitch List` - `9fin-Editorial` - `9fin-Educational` - `9fin-ESG` - `9fin-ESG QuickTake` - `9fin-Excess Spread` - `9fin-Feature` - `9fin-Frameworks` - `9fin-Friday Workout` - `9fin-Fundraising` - `9fin-Investment Grade` - `9fin-Legal Research` - `9fin-Liability Management (LME)` - `9fin-Loan Credit QuickTake` - `9fin-Loan Legal QuickTake` - `9fin-LP Wrap` - `9fin-Morning Coffee` - `9fin-Origination` - `9fin-People Moves` - `9fin-Primary` - `9fin-Private Credit` - `9fin-Restructuring QuickTake` - `9fin-Secondary` - `9fin-SRT` - `9fin-Stressed QuickTake` - `9fin-Sustainable Junk` - `9fin-Taking the Credit` - `9fin-The Default Notice` - `9fin-Top of the Flops` - `9fin-Trend Reports` - `9fin-Under the hood` - `9fin-Unicrunch` - `9fin-Watching the Defectives` - `9fin-Winding Up` - `9fin-Wrap` - `ABF Deal Update` - `Calendar` - `CLO Deal Update` - `Deal` - `Deal Updates` - `ESG` - `Loan Radar News` - `New ABF Deal` - `New CLO Deal` - `News` - `Press Release` - `Ratings` - `Regulatory Filing` - `Results`
- name: source_type in: query required: false schema: anyOf: - enum: - 9fin - third-party - all type: string - type: "null" title: Source type description: >- Filter by one of the following `9fin`, `third-party`, `all`. Defaults to `all` if omitted. `9fin` returns only 9fin-authored content, `third-party` returns content sourced from third parties, and `all` returns both. default: all description: >- Filter by one of the following `9fin`, `third-party`, `all`. Defaults to `all` if omitted. `9fin` returns only 9fin-authored content, `third-party` returns content sourced from third parties, and `all` returns both. - name: nf_ids__in in: query required: false schema: anyOf: - type: string - type: "null" title: 9fin entity IDs description: >- Comma-separated list of 9fin entity IDs to OR-filter on (maximum 10). An item is included if it references any of the supplied entitiy IDs. Example: `nf_ent_9be02202196b4567b40fcd412b14ccfe, nf_ent_300cf4bc9698484f880b4a678c8eccf5` default: null description: >- Comma-separated list of 9fin entity IDs to OR-filter on (maximum 10). An item is included if it references any of the supplied entitiy IDs. Example: `nf_ent_9be02202196b4567b40fcd412b14ccfe, nf_ent_300cf4bc9698484f880b4a678c8eccf5` - name: entity_country_code in: query required: false schema: anyOf: - type: string maxLength: 2 - type: "null" title: Country Code description: >- Filter by the country code of the main entity, as a two-letter ISO 3166-1 alpha-2 code.
Show all accepted codes - `AD` — Andorra - `AE` — United Arab Emirates - `AF` — Afghanistan - `AG` — Antigua and Barbuda - `AI` — Anguilla - `AL` — Albania - `AM` — Armenia - `AO` — Angola - `AQ` — Antarctica - `AR` — Argentina - `AS` — American Samoa - `AT` — Austria - `AU` — Australia - `AW` — Aruba - `AX` — Åland Islands - `AZ` — Azerbaijan - `BA` — Bosnia and Herzegovina - `BB` — Barbados - `BD` — Bangladesh - `BE` — Belgium - `BF` — Burkina Faso - `BG` — Bulgaria - `BH` — Bahrain - `BI` — Burundi - `BJ` — Benin - `BL` — Saint Barthélemy - `BM` — Bermuda - `BN` — Brunei Darussalam - `BO` — Bolivia, Plurinational State of - `BQ` — Bonaire, Sint Eustatius and Saba - `BR` — Brazil - `BS` — Bahamas - `BT` — Bhutan - `BV` — Bouvet Island - `BW` — Botswana - `BY` — Belarus - `BZ` — Belize - `CA` — Canada - `CC` — Cocos (Keeling) Islands - `CD` — Congo, The Democratic Republic of the - `CF` — Central African Republic - `CG` — Congo - `CH` — Switzerland - `CI` — Côte d'Ivoire - `CK` — Cook Islands - `CL` — Chile - `CM` — Cameroon - `CN` — China - `CO` — Colombia - `CR` — Costa Rica - `CU` — Cuba - `CV` — Cabo Verde - `CW` — Curaçao - `CX` — Christmas Island - `CY` — Cyprus - `CZ` — Czechia - `DE` — Germany - `DJ` — Djibouti - `DK` — Denmark - `DM` — Dominica - `DO` — Dominican Republic - `DZ` — Algeria - `EC` — Ecuador - `EE` — Estonia - `EG` — Egypt - `EH` — Western Sahara - `ER` — Eritrea - `ES` — Spain - `ET` — Ethiopia - `FI` — Finland - `FJ` — Fiji - `FK` — Falkland Islands (Malvinas) - `FM` — Micronesia, Federated States of - `FO` — Faroe Islands - `FR` — France - `GA` — Gabon - `GB` — United Kingdom - `GD` — Grenada - `GE` — Georgia - `GF` — French Guiana - `GG` — Guernsey - `GH` — Ghana - `GI` — Gibraltar - `GL` — Greenland - `GM` — Gambia - `GN` — Guinea - `GP` — Guadeloupe - `GQ` — Equatorial Guinea - `GR` — Greece - `GS` — South Georgia and the South Sandwich Islands - `GT` — Guatemala - `GU` — Guam - `GW` — Guinea-Bissau - `GY` — Guyana - `HK` — Hong Kong - `HM` — Heard Island and McDonald Islands - `HN` — Honduras - `HR` — Croatia - `HT` — Haiti - `HU` — Hungary - `ID` — Indonesia - `IE` — Ireland - `IL` — Israel - `IM` — Isle of Man - `IN` — India - `IO` — British Indian Ocean Territory - `IQ` — Iraq - `IR` — Iran, Islamic Republic of - `IS` — Iceland - `IT` — Italy - `JE` — Jersey - `JM` — Jamaica - `JO` — Jordan - `JP` — Japan - `KE` — Kenya - `KG` — Kyrgyzstan - `KH` — Cambodia - `KI` — Kiribati - `KM` — Comoros - `KN` — Saint Kitts and Nevis - `KP` — Korea, Democratic People's Republic of - `KR` — Korea, Republic of - `KW` — Kuwait - `KY` — Cayman Islands - `KZ` — Kazakhstan - `LA` — Lao People's Democratic Republic - `LB` — Lebanon - `LC` — Saint Lucia - `LI` — Liechtenstein - `LK` — Sri Lanka - `LR` — Liberia - `LS` — Lesotho - `LT` — Lithuania - `LU` — Luxembourg - `LV` — Latvia - `LY` — Libya - `MA` — Morocco - `MC` — Monaco - `MD` — Moldova, Republic of - `ME` — Montenegro - `MF` — Saint Martin (French part) - `MG` — Madagascar - `MH` — Marshall Islands - `MK` — North Macedonia - `ML` — Mali - `MM` — Myanmar - `MN` — Mongolia - `MO` — Macao - `MP` — Northern Mariana Islands - `MQ` — Martinique - `MR` — Mauritania - `MS` — Montserrat - `MT` — Malta - `MU` — Mauritius - `MV` — Maldives - `MW` — Malawi - `MX` — Mexico - `MY` — Malaysia - `MZ` — Mozambique - `NA` — Namibia - `NC` — New Caledonia - `NE` — Niger - `NF` — Norfolk Island - `NG` — Nigeria - `NI` — Nicaragua - `NL` — Netherlands - `NO` — Norway - `NP` — Nepal - `NR` — Nauru - `NU` — Niue - `NZ` — New Zealand - `OM` — Oman - `PA` — Panama - `PE` — Peru - `PF` — French Polynesia - `PG` — Papua New Guinea - `PH` — Philippines - `PK` — Pakistan - `PL` — Poland - `PM` — Saint Pierre and Miquelon - `PN` — Pitcairn - `PR` — Puerto Rico - `PS` — Palestine, State of - `PT` — Portugal - `PW` — Palau - `PY` — Paraguay - `QA` — Qatar - `RE` — Réunion - `RO` — Romania - `RS` — Serbia - `RU` — Russian Federation - `RW` — Rwanda - `SA` — Saudi Arabia - `SB` — Solomon Islands - `SC` — Seychelles - `SD` — Sudan - `SE` — Sweden - `SG` — Singapore - `SH` — Saint Helena, Ascension and Tristan da Cunha - `SI` — Slovenia - `SJ` — Svalbard and Jan Mayen - `SK` — Slovakia - `SL` — Sierra Leone - `SM` — San Marino - `SN` — Senegal - `SO` — Somalia - `SR` — Suriname - `SS` — South Sudan - `ST` — Sao Tome and Principe - `SV` — El Salvador - `SX` — Sint Maarten (Dutch part) - `SY` — Syrian Arab Republic - `SZ` — Eswatini - `TC` — Turks and Caicos Islands - `TD` — Chad - `TF` — French Southern Territories - `TG` — Togo - `TH` — Thailand - `TJ` — Tajikistan - `TK` — Tokelau - `TL` — Timor-Leste - `TM` — Turkmenistan - `TN` — Tunisia - `TO` — Tonga - `TR` — Türkiye - `TT` — Trinidad and Tobago - `TV` — Tuvalu - `TW` — Taiwan, Province of China - `TZ` — Tanzania, United Republic of - `UA` — Ukraine - `UG` — Uganda - `UM` — United States Minor Outlying Islands - `US` — United States - `UY` — Uruguay - `UZ` — Uzbekistan - `VA` — Holy See (Vatican City State) - `VC` — Saint Vincent and the Grenadines - `VE` — Venezuela, Bolivarian Republic of - `VG` — Virgin Islands, British - `VI` — Virgin Islands, U.S. - `VN` — Viet Nam - `VU` — Vanuatu - `WF` — Wallis and Futuna - `WS` — Samoa - `YE` — Yemen - `YT` — Mayotte - `ZA` — South Africa - `ZM` — Zambia - `ZW` — Zimbabwe
default: null description: >- Filter by the country code of the main entity, as a two-letter ISO 3166-1 alpha-2 code.
Show all accepted codes - `AD` — Andorra - `AE` — United Arab Emirates - `AF` — Afghanistan - `AG` — Antigua and Barbuda - `AI` — Anguilla - `AL` — Albania - `AM` — Armenia - `AO` — Angola - `AQ` — Antarctica - `AR` — Argentina - `AS` — American Samoa - `AT` — Austria - `AU` — Australia - `AW` — Aruba - `AX` — Åland Islands - `AZ` — Azerbaijan - `BA` — Bosnia and Herzegovina - `BB` — Barbados - `BD` — Bangladesh - `BE` — Belgium - `BF` — Burkina Faso - `BG` — Bulgaria - `BH` — Bahrain - `BI` — Burundi - `BJ` — Benin - `BL` — Saint Barthélemy - `BM` — Bermuda - `BN` — Brunei Darussalam - `BO` — Bolivia, Plurinational State of - `BQ` — Bonaire, Sint Eustatius and Saba - `BR` — Brazil - `BS` — Bahamas - `BT` — Bhutan - `BV` — Bouvet Island - `BW` — Botswana - `BY` — Belarus - `BZ` — Belize - `CA` — Canada - `CC` — Cocos (Keeling) Islands - `CD` — Congo, The Democratic Republic of the - `CF` — Central African Republic - `CG` — Congo - `CH` — Switzerland - `CI` — Côte d'Ivoire - `CK` — Cook Islands - `CL` — Chile - `CM` — Cameroon - `CN` — China - `CO` — Colombia - `CR` — Costa Rica - `CU` — Cuba - `CV` — Cabo Verde - `CW` — Curaçao - `CX` — Christmas Island - `CY` — Cyprus - `CZ` — Czechia - `DE` — Germany - `DJ` — Djibouti - `DK` — Denmark - `DM` — Dominica - `DO` — Dominican Republic - `DZ` — Algeria - `EC` — Ecuador - `EE` — Estonia - `EG` — Egypt - `EH` — Western Sahara - `ER` — Eritrea - `ES` — Spain - `ET` — Ethiopia - `FI` — Finland - `FJ` — Fiji - `FK` — Falkland Islands (Malvinas) - `FM` — Micronesia, Federated States of - `FO` — Faroe Islands - `FR` — France - `GA` — Gabon - `GB` — United Kingdom - `GD` — Grenada - `GE` — Georgia - `GF` — French Guiana - `GG` — Guernsey - `GH` — Ghana - `GI` — Gibraltar - `GL` — Greenland - `GM` — Gambia - `GN` — Guinea - `GP` — Guadeloupe - `GQ` — Equatorial Guinea - `GR` — Greece - `GS` — South Georgia and the South Sandwich Islands - `GT` — Guatemala - `GU` — Guam - `GW` — Guinea-Bissau - `GY` — Guyana - `HK` — Hong Kong - `HM` — Heard Island and McDonald Islands - `HN` — Honduras - `HR` — Croatia - `HT` — Haiti - `HU` — Hungary - `ID` — Indonesia - `IE` — Ireland - `IL` — Israel - `IM` — Isle of Man - `IN` — India - `IO` — British Indian Ocean Territory - `IQ` — Iraq - `IR` — Iran, Islamic Republic of - `IS` — Iceland - `IT` — Italy - `JE` — Jersey - `JM` — Jamaica - `JO` — Jordan - `JP` — Japan - `KE` — Kenya - `KG` — Kyrgyzstan - `KH` — Cambodia - `KI` — Kiribati - `KM` — Comoros - `KN` — Saint Kitts and Nevis - `KP` — Korea, Democratic People's Republic of - `KR` — Korea, Republic of - `KW` — Kuwait - `KY` — Cayman Islands - `KZ` — Kazakhstan - `LA` — Lao People's Democratic Republic - `LB` — Lebanon - `LC` — Saint Lucia - `LI` — Liechtenstein - `LK` — Sri Lanka - `LR` — Liberia - `LS` — Lesotho - `LT` — Lithuania - `LU` — Luxembourg - `LV` — Latvia - `LY` — Libya - `MA` — Morocco - `MC` — Monaco - `MD` — Moldova, Republic of - `ME` — Montenegro - `MF` — Saint Martin (French part) - `MG` — Madagascar - `MH` — Marshall Islands - `MK` — North Macedonia - `ML` — Mali - `MM` — Myanmar - `MN` — Mongolia - `MO` — Macao - `MP` — Northern Mariana Islands - `MQ` — Martinique - `MR` — Mauritania - `MS` — Montserrat - `MT` — Malta - `MU` — Mauritius - `MV` — Maldives - `MW` — Malawi - `MX` — Mexico - `MY` — Malaysia - `MZ` — Mozambique - `NA` — Namibia - `NC` — New Caledonia - `NE` — Niger - `NF` — Norfolk Island - `NG` — Nigeria - `NI` — Nicaragua - `NL` — Netherlands - `NO` — Norway - `NP` — Nepal - `NR` — Nauru - `NU` — Niue - `NZ` — New Zealand - `OM` — Oman - `PA` — Panama - `PE` — Peru - `PF` — French Polynesia - `PG` — Papua New Guinea - `PH` — Philippines - `PK` — Pakistan - `PL` — Poland - `PM` — Saint Pierre and Miquelon - `PN` — Pitcairn - `PR` — Puerto Rico - `PS` — Palestine, State of - `PT` — Portugal - `PW` — Palau - `PY` — Paraguay - `QA` — Qatar - `RE` — Réunion - `RO` — Romania - `RS` — Serbia - `RU` — Russian Federation - `RW` — Rwanda - `SA` — Saudi Arabia - `SB` — Solomon Islands - `SC` — Seychelles - `SD` — Sudan - `SE` — Sweden - `SG` — Singapore - `SH` — Saint Helena, Ascension and Tristan da Cunha - `SI` — Slovenia - `SJ` — Svalbard and Jan Mayen - `SK` — Slovakia - `SL` — Sierra Leone - `SM` — San Marino - `SN` — Senegal - `SO` — Somalia - `SR` — Suriname - `SS` — South Sudan - `ST` — Sao Tome and Principe - `SV` — El Salvador - `SX` — Sint Maarten (Dutch part) - `SY` — Syrian Arab Republic - `SZ` — Eswatini - `TC` — Turks and Caicos Islands - `TD` — Chad - `TF` — French Southern Territories - `TG` — Togo - `TH` — Thailand - `TJ` — Tajikistan - `TK` — Tokelau - `TL` — Timor-Leste - `TM` — Turkmenistan - `TN` — Tunisia - `TO` — Tonga - `TR` — Türkiye - `TT` — Trinidad and Tobago - `TV` — Tuvalu - `TW` — Taiwan, Province of China - `TZ` — Tanzania, United Republic of - `UA` — Ukraine - `UG` — Uganda - `UM` — United States Minor Outlying Islands - `US` — United States - `UY` — Uruguay - `UZ` — Uzbekistan - `VA` — Holy See (Vatican City State) - `VC` — Saint Vincent and the Grenadines - `VE` — Venezuela, Bolivarian Republic of - `VG` — Virgin Islands, British - `VI` — Virgin Islands, U.S. - `VN` — Viet Nam - `VU` — Vanuatu - `WF` — Wallis and Futuna - `WS` — Samoa - `YE` — Yemen - `YT` — Mayotte - `ZA` — South Africa - `ZM` — Zambia - `ZW` — Zimbabwe
- name: industries__in in: query required: false schema: anyOf: - type: string - type: "null" title: Industries description: >- Comma-separated list of industries to OR-filter on (maximum 5). An item is included if it references any of the supplied industries. Example: `Banks, Software & Services`
Show all accepted industries - `Aerospace / Defense` - `Alcoholic Beverage` - `Apparel` - `Automotive Manufacturer` - `Automotive Supplier` - `Banks` - `Chemical` - `Commercial & Professional Services` - `Communications Infrastructure` - `Construction and Engineering` - `Construction Materials` - `Consumer Durables` - `Consumer Services` - `Diversified Financials` - `Diversified Technology` - `Electric Utilities and Power` - `Energy, Oilfield Services` - `Energy, Oil & Gas` - `Environmental Services and Waste Management Cos.` - `Equipment Rental` - `Food Products` - `Gaming` - `Health Care Equipment & Services` - `Homebuilding And Property Development` - `Hotels, Resorts & Cruise Lines` - `Independent Power and Renewable Electricity Producers` - `Insurance` - `Manufacturing` - `Media Industry` - `Mining` - `Multi-Utilities and Power` - `Packaging` - `Paper and Forest Products` - `Pharmaceuticals, Biotechnology & Life Sciences` - `Protein and Agriculture` - `REITs and Other Commercial Property Firms` - `Restaurants` - `Retailing` - `Soft Beverage` - `Software & Services` - `Steel` - `Telecommunications` - `Transportation and Logistics` - `Water Utilities`
default: null description: >- Comma-separated list of industries to OR-filter on (maximum 5). An item is included if it references any of the supplied industries. Example: `Banks, Software & Services`
Show all accepted industries - `Aerospace / Defense` - `Alcoholic Beverage` - `Apparel` - `Automotive Manufacturer` - `Automotive Supplier` - `Banks` - `Chemical` - `Commercial & Professional Services` - `Communications Infrastructure` - `Construction and Engineering` - `Construction Materials` - `Consumer Durables` - `Consumer Services` - `Diversified Financials` - `Diversified Technology` - `Electric Utilities and Power` - `Energy, Oilfield Services` - `Energy, Oil & Gas` - `Environmental Services and Waste Management Cos.` - `Equipment Rental` - `Food Products` - `Gaming` - `Health Care Equipment & Services` - `Homebuilding And Property Development` - `Hotels, Resorts & Cruise Lines` - `Independent Power and Renewable Electricity Producers` - `Insurance` - `Manufacturing` - `Media Industry` - `Mining` - `Multi-Utilities and Power` - `Packaging` - `Paper and Forest Products` - `Pharmaceuticals, Biotechnology & Life Sciences` - `Protein and Agriculture` - `REITs and Other Commercial Property Firms` - `Restaurants` - `Retailing` - `Soft Beverage` - `Software & Services` - `Steel` - `Telecommunications` - `Transportation and Logistics` - `Water Utilities`
- name: region in: query required: false schema: anyOf: - enum: - APAC - CEEMEA - LATAM - North America - US - Europe - Western Europe type: string - type: "null" title: Region description: Filter by the coverage region (case-insensitive). default: null description: Filter by the coverage region (case-insensitive). - name: since in: query required: false schema: anyOf: - type: string format: date-time - type: "null" title: Since description: >- Only return headlines published at or after this instant. ISO 8601 datetime; if a date-only value is supplied, it is interpreted as midnight UTC. If no timezone is provided, UTC is assumed. Examples: `2026-01-01T00:00:00Z`, `2026-01-01T15:35:45`, `2026-01-01` default: null description: >- Only return headlines published at or after this instant. ISO 8601 datetime; if a date-only value is supplied, it is interpreted as midnight UTC. If no timezone is provided, UTC is assumed. Examples: `2026-01-01T00:00:00Z`, `2026-01-01T15:35:45`, `2026-01-01` - name: until in: query required: false schema: anyOf: - type: string format: date-time - type: "null" title: Until description: >- Only return headlines published at or before this instant. ISO 8601 datetime; if a date-only value is supplied, it is interpreted as midnight UTC. If no timezone is provided, UTC is assumed. Must be strictly after `since` when both are supplied. Examples: `2026-02-03T00:00:00Z`, `2026-01-01T15:35:45`, `2026-01-01` default: null description: >- Only return headlines published at or before this instant. ISO 8601 datetime; if a date-only value is supplied, it is interpreted as midnight UTC. If no timezone is provided, UTC is assumed. Must be strictly after `since` when both are supplied. Examples: `2026-02-03T00:00:00Z`, `2026-01-01T15:35:45`, `2026-01-01` responses: "200": description: Successful Response content: application/json: schema: $ref: "#/components/schemas/GetHeadlinesResponse" "400": description: "`invalid_cursor`, `invalid_content_tag`, `invalid_nf_ids`, `invalid_date_range`, " content: application/json: schema: $ref: "#/components/schemas/ErrorResponse" "422": description: Validation Error content: application/json: schema: $ref: "#/components/schemas/HTTPValidationError" "500": description: An unexpected error occurred content: application/json: schema: $ref: "#/components/schemas/InternalServerErrorResponse" security: - BearerAuth: [] components: schemas: GetHeadlinesResponse: properties: items: items: $ref: "#/components/schemas/NewsHeadline" type: array title: Items next_cursor: anyOf: - type: string - type: "null" title: Next Cursor description: Opaque cursor for fetching the next page. Pass it back unchanged as the `cursor` query parameter on the next request. `null` when this is the last page. examples: - MjAyNi0wMS0xNVQxNDozMjowMCswMDowMDozZmE4NWY2NC01NzE3LTQ1NjItYjNmYy0yYzk2M2Y2NmFmYTY= type: object required: - items title: GetHeadlinesResponse ErrorResponse: properties: error_code: type: string title: Error Code message: type: string title: Message trace_id: anyOf: - type: string - type: "null" title: Trace Id type: object required: - error_code - message - trace_id title: ErrorResponse examples: - error_code: invalid_cursor message: The supplied cursor could not be decoded. trace_id: 202bde256c7d446f9623efdc96286c5d - error_code: invalid_content_tag message: "invalid content_tags: ['invalid']" trace_id: c2416d52c6d14c8e831aad792407442c - error_code: invalid_nf_ids message: at most 10 nf_ids may be provided trace_id: a7917e8250d74e898d415b5a948d46f8 HTTPValidationError: properties: detail: items: $ref: "#/components/schemas/ValidationError" type: array title: Detail type: object title: HTTPValidationError InternalServerErrorResponse: properties: error_code: type: string title: Error Code examples: - internal_server_error message: type: string title: Message examples: - An unexpected error occurred. trace_id: anyOf: - type: string - type: "null" title: Trace Id examples: - e7dfd20231374d308f04655eb0538be4 type: object required: - error_code - message - trace_id title: InternalServerErrorResponse NewsHeadline: properties: uuid: type: string title: Uuid description: Unique identifier for the news headline. examples: - 3fa85f64-5717-4562-b3fc-2c963f66afa6 title: type: string title: Title description: Headline title text. examples: - Acme Corp announces refinancing of senior notes url: type: string title: Url description: URL of the article, pointing to the source (third-party or 9fin). examples: - https://example.com/news/acme-refinancing source: $ref: "#/components/schemas/SourceObject" description: Origin of the content, either 9fin or a third-party publisher. entities: $ref: "#/components/schemas/EntitiesObject" description: Companies and entities referenced by the headline, split into the main entity and any additional ones. regions: items: type: string type: array title: Regions description: Geographic regions the event or entity is tagged with. examples: - - APAC - CEEMEA - LATAM - North America - US - Europe - Western Europe industry: $ref: "#/components/schemas/IndustryObject" description: The industry the event is associated with. examples: - Banks - Financial Services content_tags: items: $ref: "#/components/schemas/ContentTagObject" type: array title: Content Tags description: Content tags categorising the headline by topic and vertical. published_at: type: string format: date-time title: Published At description: Timestamp when the headline was originally published (UTC). processed_at: type: string format: date-time title: Processed At description: Timestamp when the headline was processed by the news pipeline (UTC). updated_at: type: string format: date-time title: Updated At description: Timestamp when the headline was last updated (UTC). type: object required: - uuid - title - url - source - entities - regions - industry - content_tags - published_at - processed_at - updated_at title: NewsHeadline ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError SourceObject: properties: type: $ref: "#/components/schemas/ContentSource" type: object required: - type title: SourceObject EntitiesObject: properties: main: anyOf: - $ref: "#/components/schemas/MainEntityObject" - type: "null" additional: items: $ref: "#/components/schemas/AdditionalEntityObject" type: array title: Additional type: object required: - additional title: EntitiesObject IndustryObject: properties: name: anyOf: - type: string - type: "null" title: Name type: object title: IndustryObject ContentTagObject: properties: tag_name: type: string title: Tag Name vertical_name: type: string title: Vertical Name type: object required: - tag_name - vertical_name title: ContentTagObject ContentSource: type: string enum: - 9fin - third-party title: ContentSource MainEntityObject: properties: nf_id: type: string title: Nf Id name: anyOf: - type: string - type: "null" title: Name country_code: anyOf: - type: string - type: "null" title: Country Code type: object required: - nf_id title: MainEntityObject AdditionalEntityObject: properties: nf_id: type: string title: Nf Id name: anyOf: - type: string - type: "null" title: Name type: object required: - nf_id title: AdditionalEntityObject securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: "**[How to get an access token](https://console.9fin.com/getting-started/consume-api)**" ```