---
title: "9fin News & Content API - v2"
url: "https://console.9fin.com/apis/news-api-v2/versions/d8d91da6-77d3-48db-a023-e71b20cfd311"
---

# 9fin News & Content API - v2

OpenAPI specification document.

```json
{"openapi":"3.1.0","info":{"title":"9fin News & Content API - v2","version":"0.3.38"},"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. \n\nExample: `MjAyNi0wNy0xN1QwMTozNTozNC40ODo0MWY0OThhNy1jOTliLTQ5NmItOGViMi1lNzIzYjdlZDUzYTM=`","default":null},"description":"Opaque pagination cursor from a previous response's `next_cursor`; omit for the first page. \n\nExample: `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`\n\n<details><summary>Show example of valid content tags</summary>\n\n- `9fin-9Questions`\n- `9fin-ABS`\n- `9fin-All`\n- `9fin-Announcement`\n- `9fin-Asset Based Finance`\n- `9fin-Bankruptcy QuickTake`\n- `9fin-Blessed to be Stressed`\n- `9fin-Bond Legal QuickTake`\n- `9fin-CLO`\n- `9fin-CLO Primary`\n- `9fin-Cloud 9fin`\n- `9fin-Credit QuickTake`\n- `9fin-Deal Predictions`\n- `9fin-Deal Preview`\n- `9fin-Distressed`\n- `9fin-Distressed Pitch List`\n- `9fin-Editorial`\n- `9fin-Educational`\n- `9fin-ESG`\n- `9fin-ESG QuickTake`\n- `9fin-Excess Spread`\n- `9fin-Feature`\n- `9fin-Frameworks`\n- `9fin-Friday Workout`\n- `9fin-Fundraising`\n- `9fin-Investment Grade`\n- `9fin-Legal Research`\n- `9fin-Liability Management (LME)`\n- `9fin-Loan Credit QuickTake`\n- `9fin-Loan Legal QuickTake`\n- `9fin-LP Wrap`\n- `9fin-Morning Coffee`\n- `9fin-Origination`\n- `9fin-People Moves`\n- `9fin-Primary`\n- `9fin-Private Credit`\n- `9fin-Restructuring QuickTake`\n- `9fin-Secondary`\n- `9fin-SRT`\n- `9fin-Stressed QuickTake`\n- `9fin-Sustainable Junk`\n- `9fin-Taking the Credit`\n- `9fin-The Default Notice`\n- `9fin-Top of the Flops`\n- `9fin-Trend Reports`\n- `9fin-Under the hood`\n- `9fin-Unicrunch`\n- `9fin-Watching the Defectives`\n- `9fin-Winding Up`\n- `9fin-Wrap`\n- `ABF Deal Update`\n- `Calendar`\n- `CLO Deal Update`\n- `Deal`\n- `Deal Updates`\n- `ESG`\n- `Loan Radar News`\n- `New ABF Deal`\n- `New CLO Deal`\n- `News`\n- `Press Release`\n- `Ratings`\n- `Regulatory Filing`\n- `Results`\n\n</details>","default":null},"description":"Comma-separated list of content tags to OR-filter on (maximum 5). Example: `9fin-All, 9fin-Primary`\n\n<details><summary>Show example of valid content tags</summary>\n\n- `9fin-9Questions`\n- `9fin-ABS`\n- `9fin-All`\n- `9fin-Announcement`\n- `9fin-Asset Based Finance`\n- `9fin-Bankruptcy QuickTake`\n- `9fin-Blessed to be Stressed`\n- `9fin-Bond Legal QuickTake`\n- `9fin-CLO`\n- `9fin-CLO Primary`\n- `9fin-Cloud 9fin`\n- `9fin-Credit QuickTake`\n- `9fin-Deal Predictions`\n- `9fin-Deal Preview`\n- `9fin-Distressed`\n- `9fin-Distressed Pitch List`\n- `9fin-Editorial`\n- `9fin-Educational`\n- `9fin-ESG`\n- `9fin-ESG QuickTake`\n- `9fin-Excess Spread`\n- `9fin-Feature`\n- `9fin-Frameworks`\n- `9fin-Friday Workout`\n- `9fin-Fundraising`\n- `9fin-Investment Grade`\n- `9fin-Legal Research`\n- `9fin-Liability Management (LME)`\n- `9fin-Loan Credit QuickTake`\n- `9fin-Loan Legal QuickTake`\n- `9fin-LP Wrap`\n- `9fin-Morning Coffee`\n- `9fin-Origination`\n- `9fin-People Moves`\n- `9fin-Primary`\n- `9fin-Private Credit`\n- `9fin-Restructuring QuickTake`\n- `9fin-Secondary`\n- `9fin-SRT`\n- `9fin-Stressed QuickTake`\n- `9fin-Sustainable Junk`\n- `9fin-Taking the Credit`\n- `9fin-The Default Notice`\n- `9fin-Top of the Flops`\n- `9fin-Trend Reports`\n- `9fin-Under the hood`\n- `9fin-Unicrunch`\n- `9fin-Watching the Defectives`\n- `9fin-Winding Up`\n- `9fin-Wrap`\n- `ABF Deal Update`\n- `Calendar`\n- `CLO Deal Update`\n- `Deal`\n- `Deal Updates`\n- `ESG`\n- `Loan Radar News`\n- `New ABF Deal`\n- `New CLO Deal`\n- `News`\n- `Press Release`\n- `Ratings`\n- `Regulatory Filing`\n- `Results`\n\n</details>"},{"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. \n\n`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. \n\n`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. \n\nExample: `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. \n\nExample: `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.\n\n<details><summary>Show all accepted codes</summary>\n\n- `AD` — Andorra\n- `AE` — United Arab Emirates\n- `AF` — Afghanistan\n- `AG` — Antigua and Barbuda\n- `AI` — Anguilla\n- `AL` — Albania\n- `AM` — Armenia\n- `AO` — Angola\n- `AQ` — Antarctica\n- `AR` — Argentina\n- `AS` — American Samoa\n- `AT` — Austria\n- `AU` — Australia\n- `AW` — Aruba\n- `AX` — Åland Islands\n- `AZ` — Azerbaijan\n- `BA` — Bosnia and Herzegovina\n- `BB` — Barbados\n- `BD` — Bangladesh\n- `BE` — Belgium\n- `BF` — Burkina Faso\n- `BG` — Bulgaria\n- `BH` — Bahrain\n- `BI` — Burundi\n- `BJ` — Benin\n- `BL` — Saint Barthélemy\n- `BM` — Bermuda\n- `BN` — Brunei Darussalam\n- `BO` — Bolivia, Plurinational State of\n- `BQ` — Bonaire, Sint Eustatius and Saba\n- `BR` — Brazil\n- `BS` — Bahamas\n- `BT` — Bhutan\n- `BV` — Bouvet Island\n- `BW` — Botswana\n- `BY` — Belarus\n- `BZ` — Belize\n- `CA` — Canada\n- `CC` — Cocos (Keeling) Islands\n- `CD` — Congo, The Democratic Republic of the\n- `CF` — Central African Republic\n- `CG` — Congo\n- `CH` — Switzerland\n- `CI` — Côte d'Ivoire\n- `CK` — Cook Islands\n- `CL` — Chile\n- `CM` — Cameroon\n- `CN` — China\n- `CO` — Colombia\n- `CR` — Costa Rica\n- `CU` — Cuba\n- `CV` — Cabo Verde\n- `CW` — Curaçao\n- `CX` — Christmas Island\n- `CY` — Cyprus\n- `CZ` — Czechia\n- `DE` — Germany\n- `DJ` — Djibouti\n- `DK` — Denmark\n- `DM` — Dominica\n- `DO` — Dominican Republic\n- `DZ` — Algeria\n- `EC` — Ecuador\n- `EE` — Estonia\n- `EG` — Egypt\n- `EH` — Western Sahara\n- `ER` — Eritrea\n- `ES` — Spain\n- `ET` — Ethiopia\n- `FI` — Finland\n- `FJ` — Fiji\n- `FK` — Falkland Islands (Malvinas)\n- `FM` — Micronesia, Federated States of\n- `FO` — Faroe Islands\n- `FR` — France\n- `GA` — Gabon\n- `GB` — United Kingdom\n- `GD` — Grenada\n- `GE` — Georgia\n- `GF` — French Guiana\n- `GG` — Guernsey\n- `GH` — Ghana\n- `GI` — Gibraltar\n- `GL` — Greenland\n- `GM` — Gambia\n- `GN` — Guinea\n- `GP` — Guadeloupe\n- `GQ` — Equatorial Guinea\n- `GR` — Greece\n- `GS` — South Georgia and the South Sandwich Islands\n- `GT` — Guatemala\n- `GU` — Guam\n- `GW` — Guinea-Bissau\n- `GY` — Guyana\n- `HK` — Hong Kong\n- `HM` — Heard Island and McDonald Islands\n- `HN` — Honduras\n- `HR` — Croatia\n- `HT` — Haiti\n- `HU` — Hungary\n- `ID` — Indonesia\n- `IE` — Ireland\n- `IL` — Israel\n- `IM` — Isle of Man\n- `IN` — India\n- `IO` — British Indian Ocean Territory\n- `IQ` — Iraq\n- `IR` — Iran, Islamic Republic of\n- `IS` — Iceland\n- `IT` — Italy\n- `JE` — Jersey\n- `JM` — Jamaica\n- `JO` — Jordan\n- `JP` — Japan\n- `KE` — Kenya\n- `KG` — Kyrgyzstan\n- `KH` — Cambodia\n- `KI` — Kiribati\n- `KM` — Comoros\n- `KN` — Saint Kitts and Nevis\n- `KP` — Korea, Democratic People's Republic of\n- `KR` — Korea, Republic of\n- `KW` — Kuwait\n- `KY` — Cayman Islands\n- `KZ` — Kazakhstan\n- `LA` — Lao People's Democratic Republic\n- `LB` — Lebanon\n- `LC` — Saint Lucia\n- `LI` — Liechtenstein\n- `LK` — Sri Lanka\n- `LR` — Liberia\n- `LS` — Lesotho\n- `LT` — Lithuania\n- `LU` — Luxembourg\n- `LV` — Latvia\n- `LY` — Libya\n- `MA` — Morocco\n- `MC` — Monaco\n- `MD` — Moldova, Republic of\n- `ME` — Montenegro\n- `MF` — Saint Martin (French part)\n- `MG` — Madagascar\n- `MH` — Marshall Islands\n- `MK` — North Macedonia\n- `ML` — Mali\n- `MM` — Myanmar\n- `MN` — Mongolia\n- `MO` — Macao\n- `MP` — Northern Mariana Islands\n- `MQ` — Martinique\n- `MR` — Mauritania\n- `MS` — Montserrat\n- `MT` — Malta\n- `MU` — Mauritius\n- `MV` — Maldives\n- `MW` — Malawi\n- `MX` — Mexico\n- `MY` — Malaysia\n- `MZ` — Mozambique\n- `NA` — Namibia\n- `NC` — New Caledonia\n- `NE` — Niger\n- `NF` — Norfolk Island\n- `NG` — Nigeria\n- `NI` — Nicaragua\n- `NL` — Netherlands\n- `NO` — Norway\n- `NP` — Nepal\n- `NR` — Nauru\n- `NU` — Niue\n- `NZ` — New Zealand\n- `OM` — Oman\n- `PA` — Panama\n- `PE` — Peru\n- `PF` — French Polynesia\n- `PG` — Papua New Guinea\n- `PH` — Philippines\n- `PK` — Pakistan\n- `PL` — Poland\n- `PM` — Saint Pierre and Miquelon\n- `PN` — Pitcairn\n- `PR` — Puerto Rico\n- `PS` — Palestine, State of\n- `PT` — Portugal\n- `PW` — Palau\n- `PY` — Paraguay\n- `QA` — Qatar\n- `RE` — Réunion\n- `RO` — Romania\n- `RS` — Serbia\n- `RU` — Russian Federation\n- `RW` — Rwanda\n- `SA` — Saudi Arabia\n- `SB` — Solomon Islands\n- `SC` — Seychelles\n- `SD` — Sudan\n- `SE` — Sweden\n- `SG` — Singapore\n- `SH` — Saint Helena, Ascension and Tristan da Cunha\n- `SI` — Slovenia\n- `SJ` — Svalbard and Jan Mayen\n- `SK` — Slovakia\n- `SL` — Sierra Leone\n- `SM` — San Marino\n- `SN` — Senegal\n- `SO` — Somalia\n- `SR` — Suriname\n- `SS` — South Sudan\n- `ST` — Sao Tome and Principe\n- `SV` — El Salvador\n- `SX` — Sint Maarten (Dutch part)\n- `SY` — Syrian Arab Republic\n- `SZ` — Eswatini\n- `TC` — Turks and Caicos Islands\n- `TD` — Chad\n- `TF` — French Southern Territories\n- `TG` — Togo\n- `TH` — Thailand\n- `TJ` — Tajikistan\n- `TK` — Tokelau\n- `TL` — Timor-Leste\n- `TM` — Turkmenistan\n- `TN` — Tunisia\n- `TO` — Tonga\n- `TR` — Türkiye\n- `TT` — Trinidad and Tobago\n- `TV` — Tuvalu\n- `TW` — Taiwan, Province of China\n- `TZ` — Tanzania, United Republic of\n- `UA` — Ukraine\n- `UG` — Uganda\n- `UM` — United States Minor Outlying Islands\n- `US` — United States\n- `UY` — Uruguay\n- `UZ` — Uzbekistan\n- `VA` — Holy See (Vatican City State)\n- `VC` — Saint Vincent and the Grenadines\n- `VE` — Venezuela, Bolivarian Republic of\n- `VG` — Virgin Islands, British\n- `VI` — Virgin Islands, U.S.\n- `VN` — Viet Nam\n- `VU` — Vanuatu\n- `WF` — Wallis and Futuna\n- `WS` — Samoa\n- `YE` — Yemen\n- `YT` — Mayotte\n- `ZA` — South Africa\n- `ZM` — Zambia\n- `ZW` — Zimbabwe\n\n</details>","default":null},"description":"Filter by the country code of the main entity, as a two-letter ISO 3166-1 alpha-2 code.\n\n<details><summary>Show all accepted codes</summary>\n\n- `AD` — Andorra\n- `AE` — United Arab Emirates\n- `AF` — Afghanistan\n- `AG` — Antigua and Barbuda\n- `AI` — Anguilla\n- `AL` — Albania\n- `AM` — Armenia\n- `AO` — Angola\n- `AQ` — Antarctica\n- `AR` — Argentina\n- `AS` — American Samoa\n- `AT` — Austria\n- `AU` — Australia\n- `AW` — Aruba\n- `AX` — Åland Islands\n- `AZ` — Azerbaijan\n- `BA` — Bosnia and Herzegovina\n- `BB` — Barbados\n- `BD` — Bangladesh\n- `BE` — Belgium\n- `BF` — Burkina Faso\n- `BG` — Bulgaria\n- `BH` — Bahrain\n- `BI` — Burundi\n- `BJ` — Benin\n- `BL` — Saint Barthélemy\n- `BM` — Bermuda\n- `BN` — Brunei Darussalam\n- `BO` — Bolivia, Plurinational State of\n- `BQ` — Bonaire, Sint Eustatius and Saba\n- `BR` — Brazil\n- `BS` — Bahamas\n- `BT` — Bhutan\n- `BV` — Bouvet Island\n- `BW` — Botswana\n- `BY` — Belarus\n- `BZ` — Belize\n- `CA` — Canada\n- `CC` — Cocos (Keeling) Islands\n- `CD` — Congo, The Democratic Republic of the\n- `CF` — Central African Republic\n- `CG` — Congo\n- `CH` — Switzerland\n- `CI` — Côte d'Ivoire\n- `CK` — Cook Islands\n- `CL` — Chile\n- `CM` — Cameroon\n- `CN` — China\n- `CO` — Colombia\n- `CR` — Costa Rica\n- `CU` — Cuba\n- `CV` — Cabo Verde\n- `CW` — Curaçao\n- `CX` — Christmas Island\n- `CY` — Cyprus\n- `CZ` — Czechia\n- `DE` — Germany\n- `DJ` — Djibouti\n- `DK` — Denmark\n- `DM` — Dominica\n- `DO` — Dominican Republic\n- `DZ` — Algeria\n- `EC` — Ecuador\n- `EE` — Estonia\n- `EG` — Egypt\n- `EH` — Western Sahara\n- `ER` — Eritrea\n- `ES` — Spain\n- `ET` — Ethiopia\n- `FI` — Finland\n- `FJ` — Fiji\n- `FK` — Falkland Islands (Malvinas)\n- `FM` — Micronesia, Federated States of\n- `FO` — Faroe Islands\n- `FR` — France\n- `GA` — Gabon\n- `GB` — United Kingdom\n- `GD` — Grenada\n- `GE` — Georgia\n- `GF` — French Guiana\n- `GG` — Guernsey\n- `GH` — Ghana\n- `GI` — Gibraltar\n- `GL` — Greenland\n- `GM` — Gambia\n- `GN` — Guinea\n- `GP` — Guadeloupe\n- `GQ` — Equatorial Guinea\n- `GR` — Greece\n- `GS` — South Georgia and the South Sandwich Islands\n- `GT` — Guatemala\n- `GU` — Guam\n- `GW` — Guinea-Bissau\n- `GY` — Guyana\n- `HK` — Hong Kong\n- `HM` — Heard Island and McDonald Islands\n- `HN` — Honduras\n- `HR` — Croatia\n- `HT` — Haiti\n- `HU` — Hungary\n- `ID` — Indonesia\n- `IE` — Ireland\n- `IL` — Israel\n- `IM` — Isle of Man\n- `IN` — India\n- `IO` — British Indian Ocean Territory\n- `IQ` — Iraq\n- `IR` — Iran, Islamic Republic of\n- `IS` — Iceland\n- `IT` — Italy\n- `JE` — Jersey\n- `JM` — Jamaica\n- `JO` — Jordan\n- `JP` — Japan\n- `KE` — Kenya\n- `KG` — Kyrgyzstan\n- `KH` — Cambodia\n- `KI` — Kiribati\n- `KM` — Comoros\n- `KN` — Saint Kitts and Nevis\n- `KP` — Korea, Democratic People's Republic of\n- `KR` — Korea, Republic of\n- `KW` — Kuwait\n- `KY` — Cayman Islands\n- `KZ` — Kazakhstan\n- `LA` — Lao People's Democratic Republic\n- `LB` — Lebanon\n- `LC` — Saint Lucia\n- `LI` — Liechtenstein\n- `LK` — Sri Lanka\n- `LR` — Liberia\n- `LS` — Lesotho\n- `LT` — Lithuania\n- `LU` — Luxembourg\n- `LV` — Latvia\n- `LY` — Libya\n- `MA` — Morocco\n- `MC` — Monaco\n- `MD` — Moldova, Republic of\n- `ME` — Montenegro\n- `MF` — Saint Martin (French part)\n- `MG` — Madagascar\n- `MH` — Marshall Islands\n- `MK` — North Macedonia\n- `ML` — Mali\n- `MM` — Myanmar\n- `MN` — Mongolia\n- `MO` — Macao\n- `MP` — Northern Mariana Islands\n- `MQ` — Martinique\n- `MR` — Mauritania\n- `MS` — Montserrat\n- `MT` — Malta\n- `MU` — Mauritius\n- `MV` — Maldives\n- `MW` — Malawi\n- `MX` — Mexico\n- `MY` — Malaysia\n- `MZ` — Mozambique\n- `NA` — Namibia\n- `NC` — New Caledonia\n- `NE` — Niger\n- `NF` — Norfolk Island\n- `NG` — Nigeria\n- `NI` — Nicaragua\n- `NL` — Netherlands\n- `NO` — Norway\n- `NP` — Nepal\n- `NR` — Nauru\n- `NU` — Niue\n- `NZ` — New Zealand\n- `OM` — Oman\n- `PA` — Panama\n- `PE` — Peru\n- `PF` — French Polynesia\n- `PG` — Papua New Guinea\n- `PH` — Philippines\n- `PK` — Pakistan\n- `PL` — Poland\n- `PM` — Saint Pierre and Miquelon\n- `PN` — Pitcairn\n- `PR` — Puerto Rico\n- `PS` — Palestine, State of\n- `PT` — Portugal\n- `PW` — Palau\n- `PY` — Paraguay\n- `QA` — Qatar\n- `RE` — Réunion\n- `RO` — Romania\n- `RS` — Serbia\n- `RU` — Russian Federation\n- `RW` — Rwanda\n- `SA` — Saudi Arabia\n- `SB` — Solomon Islands\n- `SC` — Seychelles\n- `SD` — Sudan\n- `SE` — Sweden\n- `SG` — Singapore\n- `SH` — Saint Helena, Ascension and Tristan da Cunha\n- `SI` — Slovenia\n- `SJ` — Svalbard and Jan Mayen\n- `SK` — Slovakia\n- `SL` — Sierra Leone\n- `SM` — San Marino\n- `SN` — Senegal\n- `SO` — Somalia\n- `SR` — Suriname\n- `SS` — South Sudan\n- `ST` — Sao Tome and Principe\n- `SV` — El Salvador\n- `SX` — Sint Maarten (Dutch part)\n- `SY` — Syrian Arab Republic\n- `SZ` — Eswatini\n- `TC` — Turks and Caicos Islands\n- `TD` — Chad\n- `TF` — French Southern Territories\n- `TG` — Togo\n- `TH` — Thailand\n- `TJ` — Tajikistan\n- `TK` — Tokelau\n- `TL` — Timor-Leste\n- `TM` — Turkmenistan\n- `TN` — Tunisia\n- `TO` — Tonga\n- `TR` — Türkiye\n- `TT` — Trinidad and Tobago\n- `TV` — Tuvalu\n- `TW` — Taiwan, Province of China\n- `TZ` — Tanzania, United Republic of\n- `UA` — Ukraine\n- `UG` — Uganda\n- `UM` — United States Minor Outlying Islands\n- `US` — United States\n- `UY` — Uruguay\n- `UZ` — Uzbekistan\n- `VA` — Holy See (Vatican City State)\n- `VC` — Saint Vincent and the Grenadines\n- `VE` — Venezuela, Bolivarian Republic of\n- `VG` — Virgin Islands, British\n- `VI` — Virgin Islands, U.S.\n- `VN` — Viet Nam\n- `VU` — Vanuatu\n- `WF` — Wallis and Futuna\n- `WS` — Samoa\n- `YE` — Yemen\n- `YT` — Mayotte\n- `ZA` — South Africa\n- `ZM` — Zambia\n- `ZW` — Zimbabwe\n\n</details>"},{"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. \n\nExample: `Banks, Software & Services`\n\n<details><summary>Show all accepted industries</summary>\n\n- `Aerospace / Defense`\n- `Alcoholic Beverage`\n- `Apparel`\n- `Automotive Manufacturer`\n- `Automotive Supplier`\n- `Banks`\n- `Chemical`\n- `Commercial & Professional Services`\n- `Communications Infrastructure`\n- `Construction and Engineering`\n- `Construction Materials`\n- `Consumer Durables`\n- `Consumer Services`\n- `Diversified Financials`\n- `Diversified Technology`\n- `Electric Utilities and Power`\n- `Energy, Oilfield Services`\n- `Energy, Oil & Gas`\n- `Environmental Services and Waste Management Cos.`\n- `Equipment Rental`\n- `Food Products`\n- `Gaming`\n- `Health Care Equipment & Services`\n- `Homebuilding And Property Development`\n- `Hotels, Resorts & Cruise Lines`\n- `Independent Power and Renewable Electricity Producers`\n- `Insurance`\n- `Manufacturing`\n- `Media Industry`\n- `Mining`\n- `Multi-Utilities and Power`\n- `Packaging`\n- `Paper and Forest Products`\n- `Pharmaceuticals, Biotechnology & Life Sciences`\n- `Protein and Agriculture`\n- `REITs and Other Commercial Property Firms`\n- `Restaurants`\n- `Retailing`\n- `Soft Beverage`\n- `Software & Services`\n- `Steel`\n- `Telecommunications`\n- `Transportation and Logistics`\n- `Water Utilities`\n\n</details>","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. \n\nExample: `Banks, Software & Services`\n\n<details><summary>Show all accepted industries</summary>\n\n- `Aerospace / Defense`\n- `Alcoholic Beverage`\n- `Apparel`\n- `Automotive Manufacturer`\n- `Automotive Supplier`\n- `Banks`\n- `Chemical`\n- `Commercial & Professional Services`\n- `Communications Infrastructure`\n- `Construction and Engineering`\n- `Construction Materials`\n- `Consumer Durables`\n- `Consumer Services`\n- `Diversified Financials`\n- `Diversified Technology`\n- `Electric Utilities and Power`\n- `Energy, Oilfield Services`\n- `Energy, Oil & Gas`\n- `Environmental Services and Waste Management Cos.`\n- `Equipment Rental`\n- `Food Products`\n- `Gaming`\n- `Health Care Equipment & Services`\n- `Homebuilding And Property Development`\n- `Hotels, Resorts & Cruise Lines`\n- `Independent Power and Renewable Electricity Producers`\n- `Insurance`\n- `Manufacturing`\n- `Media Industry`\n- `Mining`\n- `Multi-Utilities and Power`\n- `Packaging`\n- `Paper and Forest Products`\n- `Pharmaceuticals, Biotechnology & Life Sciences`\n- `Protein and Agriculture`\n- `REITs and Other Commercial Property Firms`\n- `Restaurants`\n- `Retailing`\n- `Soft Beverage`\n- `Software & Services`\n- `Steel`\n- `Telecommunications`\n- `Transportation and Logistics`\n- `Water Utilities`\n\n</details>"},{"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. \n\nExamples: `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. \n\nExamples: `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. \n\nExamples: `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. \n\nExamples: `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"}}}}}}},"/v2/news/{uuid}":{"get":{"tags":[],"summary":"Get News Item By Uuid","description":"Get the full content for a specific news article by UUID.","operationId":"get_news_item_by_uuid_v2_news__uuid__get","parameters":[{"name":"uuid","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsItem"}}}},"404":{"description":"`news_item_not_found`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsItemNotFoundResponse"}}}},"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"}}}}}}}},"components":{"schemas":{"AdditionalEntityObject":{"properties":{"nf_id":{"type":"string","title":"Nf Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["nf_id"],"title":"AdditionalEntityObject"},"ContentFormat":{"type":"string","enum":["html","mkd"],"title":"ContentFormat"},"ContentObject":{"properties":{"format":{"$ref":"#/components/schemas/ContentFormat"},"body":{"type":"string","title":"Body"}},"type":"object","required":["format","body"],"title":"ContentObject"},"ContentSource":{"type":"string","enum":["9fin","third-party"],"title":"ContentSource"},"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"},"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"},"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"}]},"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"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IndustryObject":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","title":"IndustryObject"},"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"},"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"},"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"},"NewsItem":{"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)."},"content":{"anyOf":[{"$ref":"#/components/schemas/ContentObject"},{"type":"null"}]}},"type":"object","required":["uuid","title","url","source","entities","regions","industry","content_tags","published_at","processed_at","updated_at"],"title":"NewsItem"},"NewsItemNotFoundResponse":{"properties":{"message":{"type":"string","title":"Message"},"trace_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trace Id"}},"type":"object","required":["message","trace_id"],"title":"NewsItemNotFoundResponse","examples":[{"message":"The supplied news item ID could not be found.","trace_id":"202bde256c7d446f9623efdc96286c5d"}]},"SourceObject":{"properties":{"type":{"$ref":"#/components/schemas/ContentSource"}},"type":"object","required":["type"],"title":"SourceObject"},"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"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**[How to get an access token](https://console.9fin.com/getting-started/consume-api)**"}}},"servers":[{"url":"https://api.9fin.com","description":"prod"}],"security":[{"BearerAuth":[]}]}
```