openapi: 3.0.3
info:
title: LLM-ready API
version: 0.1.0
description: S&P Global Market Intelligence kFinance dataset via LLM-Ready API
paths:
/api/v1/auditors/:
post:
operationId: auditors_create
description: Get the financial auditors of a given company id
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AuditorRequest'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/AuditorRequest'
multipart/form-data:
schema:
$ref: '#/components/schemas/AuditorRequest'
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/AuditorResponse'
examples:
AuditorExample:
value:
'21719':
CY2025/FY2025:
- auditor_company_id: '97518'
auditor_name: Ernst & Young LLP
CY2024/FY2024:
- auditor_company_id: '97518'
auditor_name: Ernst & Young LLP
summary: '21719'
description: Indicates a successful request.
'403':
description: Indicates that the authorization is missing or invalid.
/api/v1/ciqpro/{company_ids}:
get:
operationId: ciqpro_retrieve
description: Given a list of company IDs, return a list of those IDs to their CIQ Pro keys.
parameters:
- in: path
name: company_ids
schema:
type: string
pattern: ^(\d+(,\d+)*)$
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CIQProKeys'
examples:
Example:
value:
results:
- company_id: '21719'
ciqpro_key: '4023623'
summary: '21719'
description: Indicates a successful request.
'403':
description: Indicates that the authorization is missing or invalid.
/api/v1/company_groups/geo/country/{iso_code}/{state}:
get:
operationId: Get Companies By Location
description: "Get the list of companies based in a location with filters iso_code and state.\n\nParameters:\n iso_code\
\ (string, required): The ISO 3166-1 alpha-2 or alpha-3 code representing the country. This should be a two or three\
\ letter code conforming to the ISO 3166-1 standard. Example: \"US\" or \"USA\" for the United States, \"FR\" or \"\
FRA\" for France, \"IN\" or \"IND\" for India.\n state (string, optional): The ISO 3166-2 subdivision code representing\
\ a state, province, or region within the specified country. This code identifies the subdivision without repeating\
\ the country code. Example: \"CA\" for California, \"MH\" for Maharashtra."
parameters:
- in: path
name: iso_code
schema:
type: string
pattern: ^(?i:[A-Z]{2,3})$
required: true
- in: path
name: state
schema:
type: string
pattern: ^(?i:[A-Z]{2,3})$
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CompanyListResponse'
examples:
GetCompaniesByLocationExample:
value:
companies:
- 557556508
- 915908
- 326636850
- 13757207
- 1780112191
- 291946353
- 658420583
- 408856966
summary: Country GB
description: Indicates a successful request.
'400':
description: Indicates that the query is invalid.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/company_groups/industry/{industry_classification}/{industry_code}:
get:
operationId: Get Companies By Industry Code
description: Get the list of companies that are in the given industry_classification and industry_code
parameters:
- in: path
name: industry_classification
schema:
type: string
pattern: ^(?i:ANZSIC)|(?i:NACE)|(?i:NAICS)|(?i:SIC)|(?i:SPCAPIQETF)|(?i:SPRATINGS)$
required: true
- in: path
name: industry_code
schema:
type: string
pattern: ^[a-zA-Z0-9]{1,12}$
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CompanyListResponse'
examples:
GetCompaniesByIndustryCodeExample:
value:
companies:
- 669200555
- 1755802872
- 304098666
- 20342986
- 106768890
- 104931852
- 1832449314
- 1841209336
- 600549462
- 20374017
- 3711189
summary: SIC, 6141
description: Indicates a successful request.
'400':
description: Indicates that the query is invalid.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/company_groups/industry/gics/{gics_code}:
get:
operationId: Get Companies By GICS Code
description: 'Get the list of companies that are classified in the gics_code.
Returns a dictionary of shape {"companies": List[<company_id>]}.
The gics_code can be either a 2-digit Sector code, 4-digit Industry Group code, 6-digit Industry code, or 8-digit
Sub-industry code.'
parameters:
- in: path
name: gics_code
schema:
type: string
pattern: ^([0-9]{2}|[0-9]{4}|[0-9]{6}|[0-9]{8})$
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CompanyListResponse'
examples:
GetCompaniesByGICSCodeExample:
value:
companies:
- 1905805991
- 1865646430
- 1872949585
- 1813054728
- 20934664
- 657206722
- 718559668
- 371363826
summary: '25301010'
description: Indicates a successful request.
'400':
description: Indicates that the query is invalid.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/company_groups/industry/simple/{simple_industry}:
get:
operationId: Get Companies By Simple Industry
description: Get the list of companies that are in the given simple_industry
parameters:
- in: path
name: simple_industry
schema:
type: string
pattern: ^(?i:aerospace_and_defense)|(?i:air_freight_and_logistics)|(?i:automobile_components)|(?i:automobiles)|(?i:banks)|(?i:beverages)|(?i:biotechnology)|(?i:broadline_retail)|(?i:building_products)|(?i:capital_markets)|(?i:chemicals)|(?i:commercial_services_and_supplies)|(?i:communications_equipment)|(?i:construction_and_engineering)|(?i:construction_materials)|(?i:consumer_finance)|(?i:consumer_staples_distribution_and_retail)|(?i:containers_and_packaging)|(?i:distributors)|(?i:diversified_consumer_services)|(?i:diversified_reits)|(?i:diversified_telecommunication_services)|(?i:electric_utilities)|(?i:electrical_equipment)|(?i:electronic_equipment_instruments_and_components)|(?i:energy_equipment_and_services)|(?i:entertainment)|(?i:financial_services)|(?i:food_products)|(?i:gas_utilities)|(?i:ground_transportation)|(?i:health_care_equipment_and_supplies)|(?i:health_care_providers_and_services)|(?i:health_care_reits)|(?i:health_care_technology)|(?i:hotel_and_resort_reits)|(?i:hotels_restaurants_and_leisure)|(?i:household_durables)|(?i:household_products)|(?i:independent_power_and_renewable_electricity_producers)|(?i:industrial_conglomerates)|(?i:industrial_reits)|(?i:insurance)|(?i:interactive_media_and_services)|(?i:it_services)|(?i:leisure_products)|(?i:life_sciences_tools_and_services)|(?i:machinery)|(?i:marine_transportation)|(?i:media)|(?i:metals_and_mining)|(?i:mortgage_real_estate_investment_trusts)|(?i:multi_utilities)|(?i:office_reits)|(?i:oil_gas_and_consumable_fuels)|(?i:paper_and_forest_products)|(?i:passenger_airlines)|(?i:personal_care_products)|(?i:pharmaceuticals)|(?i:professional_services)|(?i:real_estate_management_and_development)|(?i:residential_reits)|(?i:retail_reits)|(?i:semiconductors_and_semiconductor_equipment)|(?i:software)|(?i:specialized_reits)|(?i:specialty_retail)|(?i:technology_hardware_storage_and_peripherals)|(?i:textiles_apparel_and_luxury_goods)|(?i:tobacco)|(?i:trading_companies_and_distributors)|(?i:transportation_infrastructure)|(?i:water_utilities)|(?i:wireless_telecommunication_services)$
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CompanyListResponse'
examples:
GetCompaniesBySimpleIndustryExample:
value:
companies:
- 557556508
- 915908
- 326636850
- 13757207
- 1780112191
- 291946353
- 658420583
- 408856966
summary: aerospace_and_defense
description: Indicates a successful request.
'400':
description: Indicates that the query is invalid.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/competitors/{company_id}:
get:
operationId: Get Competitors from Company
description: "Get the list of company_id and company_name that are competitors of company_id, optionally filtered by\
\ the competitor_source type.\n\nParameters:\n company_id (int): The requested company_id\n competitor_source\
\ (CompetitorSourceType): The source type of the competitor information: 'filing' (from SEC filings), 'key_dev' (from\
\ key developments), 'contact' (from contact relationships), 'third_party' (from third-party sources), 'self_identified'\
\ (self-identified), 'named_by_competitor' (from competitor's perspective).\"\nReturns a dictionary of shape {\"competitors\"\
: List[{“company_id”: <company_id>, \"company_name\": <company_name>}]},"
parameters:
- in: path
name: company_id
schema:
type: integer
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Competitors'
examples:
CompetitorsExample:
value:
competitors:
- company_id: 8122148
company_name: Experian plc
- company_id: 109450
company_name: MarketAxess Holdings Inc.
- company_id: 4973712
company_name: Stride, Inc.
summary: 21719, named_by_competitor
description: Indicates a successful request.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/competitors/{company_id}/{competitor_source}:
get:
operationId: Get Competitors from Company_2
description: "Get the list of company_id and company_name that are competitors of company_id, optionally filtered by\
\ the competitor_source type.\n\nParameters:\n company_id (int): The requested company_id\n competitor_source\
\ (CompetitorSourceType): The source type of the competitor information: 'filing' (from SEC filings), 'key_dev' (from\
\ key developments), 'contact' (from contact relationships), 'third_party' (from third-party sources), 'self_identified'\
\ (self-identified), 'named_by_competitor' (from competitor's perspective).\"\nReturns a dictionary of shape {\"competitors\"\
: List[{“company_id”: <company_id>, \"company_name\": <company_name>}]},"
parameters:
- in: path
name: company_id
schema:
type: integer
required: true
- in: path
name: competitor_source
schema:
type: string
pattern: ^(?i:filing)|(?i:key_dev)|(?i:contact)|(?i:third_party)|(?i:self_identified)|(?i:named_by_competitor)$
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Competitors'
examples:
CompetitorsExample:
value:
competitors:
- company_id: 8122148
company_name: Experian plc
- company_id: 109450
company_name: MarketAxess Holdings Inc.
- company_id: 4973712
company_name: Stride, Inc.
summary: 21719, named_by_competitor
description: Indicates a successful request.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/cusip/{security_id}:
get:
operationId: Get CUSIP
description: Get the CUSIP for a given security_id
parameters:
- in: path
name: security_id
schema:
type: integer
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CusipResponse'
examples:
GetCusipExample:
value:
cusip: Y11757104
summary: '20231631'
description: Indicates a successful request.
'400':
description: Indicates that the query is invalid.
'403':
description: Indicates that the authorization information is missing or invalid.
'404':
description: Indicates that no CUSIP was found for the given security_id.
/api/v1/earnings/{company_id}:
get:
operationId: Get Earnings Calls
description: 'Get metadata (name, key dev id, and datetime) for earnings calls for a given company_id.
The response comprises metadata for all upcoming and past earnings calls in
descending order by datetime. The key dev id can be used with the transcript
endpoints to retrieve the earnings call transcript.'
parameters:
- in: path
name: company_id
schema:
type: integer
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/EarningsResponse'
examples:
EarningsExample:
value:
earnings:
- name: S&P Global Inc., Q1 2025 Earnings Call, Apr 29, 2025
key_dev_id: 1916266380
datetime: '2025-02-11 13:30:00.000'
summary: '24937'
description: Indicates a successful request.
'400':
description: Indicates that request parameters are invalid.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/earnings/{company_id}/dates:
get:
operationId: Get Earnings Calls Dates
description: Get the earnings calls in datetime for a given company_id in UTC
parameters:
- in: path
name: company_id
schema:
type: integer
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/EarningsDatesResponse'
examples:
EarningsDatesExample:
value:
earnings:
- '2024-02-01T22:00:00.000'
- '2023-11-02T21:00:00.000'
- '2023-08-03T21:00:00.000'
summary: '24937'
description: Indicates a successful request.
'400':
description: Indicates that request parameters are invalid.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/estimates/:
post:
operationId: Get Estimates
description: Get the consensus estimates or guidance for a given company.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/EstimatesRequest'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/EstimatesRequest'
multipart/form-data:
schema:
$ref: '#/components/schemas/EstimatesRequest'
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/EstimatesResponse'
examples:
ConsensusEstimatesQuarterlyExample:
value:
results:
'24937':
estimate_type: consensus
currency: USD
period_type: quarterly
periods:
FY2025Q4:
period_end_date: '2025-12-31'
estimates:
- name: Revenue Consensus High
value: '3955000000.000000'
- name: Revenue Consensus Low
value: '3806400000.000000'
- name: Revenue Consensus Mean
value: '3881725460.000000'
- name: Revenue Consensus Median
value: '3883000000.000000'
errors: {}
summary: '24937'
description: Indicates a successful request.
'400':
description: Indicates that the input parameters are invalid.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/estimates/analyst_recommendations/{company_id}:
get:
operationId: Get Analyst Recommendations
description: 'Get analyst recommendations for a given company_id.
Returns counts of analyst recommendations by rating category and an aggregate analyst consensus score. S&P Global
Market Intelligence
standardizes ratings across brokers on a 5-point scale: 1 = Buy, 2 = Outperform, 3 = Hold, 4 = Underperform, 5 = Sell.
If an analyst does not provide a recommendation, S&P Global assigns a rating of ''No Opinion''.'
parameters:
- in: path
name: company_id
schema:
type: integer
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/AnalystRecommendationsResponse'
examples:
ConsensusTargetPriceExample:
value:
results:
'24937':
effective_date: '2026-03-03'
estimates:
- name: Consensus Recommendation
value: '1.936170'
- name: '# of Analysts No Opinion Recommendation - (In-Consensus)'
value: '2.000000'
- name: '# of Analysts Buy Recommendation - (In-Consensus)'
value: '24.000000'
- name: '# of Analysts Sell Recommendation - (In-Consensus)'
value: '1.000000'
- name: '# of Analysts Hold Recommendation - (In-Consensus)'
value: '16.000000'
- name: '# of Analysts Outperform Recommendation - (In-Consensus)'
value: '5.000000'
- name: '# of Analysts Underperform Recommendation - (In-Consensus)'
value: '1.000000'
errors: {}
summary: '24937'
description: Indicates a successful request.
'400':
description: Indicates that the input parameters are invalid.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/estimates/consensus_target_price/{company_id}:
get:
operationId: Get Consensus Target Price
description: Get the consensus target price estimates for a given company_id.
parameters:
- in: path
name: company_id
schema:
type: integer
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ConsensusTargetPriceResponse'
examples:
ConsensusTargetPriceExample:
value:
results:
'24937':
currency: USD
effective_date: '2026-03-03'
estimates:
- name: Target Price Consensus Mean
value: '293.289020'
- name: Target Price Consensus Median
value: '300.000000'
- name: Target Price Consensus High
value: '350.000000'
- name: Target Price Consensus Low
value: '205.000000'
- name: 'Target Price - # of Estimates'
value: '41.000000'
- name: Target Price - Standard Deviation
value: '32.468260'
errors: {}
summary: '24937'
description: Indicates a successful request.
'400':
description: Indicates that the input parameters are invalid.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/fundinground/info/{transaction_id}:
get:
operationId: fundinground_info_retrieve
description: Get detailed information about a round of funding.
parameters:
- in: path
name: transaction_id
schema:
type: integer
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/RoundOfFundingInfo'
examples:
RoundOfFundingInformationExample:
value:
timeline:
announced_date: '2017-02-09'
closed_date: '2016-12-31'
participants:
target:
company_id: 251994106
company_name: Kensho Technologies, Inc.
investors:
- company_id: 21719
company_name: S&P Global Inc.
lead_investor: true
investment_value: null
- company_id: 292891
company_name: Wells Fargo & Company
lead_investor: false
investment_value: null
transaction:
funding_type: Series B
amount_offered: '50000000.00000000'
currency: USD
legal_fees: null
other_fees: null
initial_gross_amount_offered: '50000000.00000000'
offering_size_change: Unchanged
upsized_amount: '0.00000000'
upsized_amount_percent: '0.00000000'
pre_money_valuation: '450000000.00000000'
post_money_valuation: '500000000.00000000'
aggregate_amount_raised: '104961538.00000000'
liquidation_preference: null
anti_dilution_method: null
liquidation_price: null
option_pool: null
participating_preferred_cap: null
liquidation_preference_multiple: null
use_of_proceeds: Kensho Technologies Inc. will use the proceeds in part toward buying more data sets
to supplement its current pool of information and toward bringing its technology to other industries.
pre_deal_situation: null
redemption: null
cumulative_dividends: null
reorganization: null
pay_to_play: null
pay_to_play_penalties: null
security:
dividend_per_share: null
annualized_dividend_rate: null
seniority_level: null
coupon_type: null
funding_convertible_type: null
security_description: Undisclosed
class_series_tranche: null
summary: 'transaction id: 273766'
description: Indicates a successful request.
'400':
description: Indicates that the query is invalid.
'403':
description: Indicates that the authorization information is missing or invalid.
'404':
description: Indicates that no round of funding info was found for the given transaction_id.
/api/v1/fundinground/info/{transaction_id}/advisors/investor/{advised_company_id}:
get:
operationId: fundinground_info_advisors_investor_retrieve
description: Get the advisors and their types for a company buying into a round of funding.
parameters:
- in: path
name: advised_company_id
schema:
type: integer
required: true
- in: path
name: transaction_id
schema:
type: integer
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/AdvisorsResponse'
examples:
AdvisorsForRoundOfFundingInvestorCompanyExample:
value:
advisors:
- advisor_company_id: 22439
advisor_company_name: DLA Piper LLP (US)
advisor_type_name: Legal Counsel
advisor_fee_amount: '3750000.0000'
advisor_fee_currency: USD
is_lead: true
summary: 'transaction id: 4299145, company id: 21719'
description: Indicates a successful request.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/fundinground/info/{transaction_id}/advisors/target:
get:
operationId: fundinground_info_advisors_target_retrieve
description: Get the advisors and their types for the company raising a round of funding.
parameters:
- in: path
name: transaction_id
schema:
type: integer
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/AdvisorsResponse'
examples:
AdvisorsForCompanyRaisingRoundOfFundingExample:
value:
advisors:
- advisor_company_id: 286743412
advisor_company_name: PJT Partners Inc.
advisor_type_name: Financial Adviser
advisor_fee_amount: '2500000.0000'
advisor_fee_currency: USD
is_lead: true
- advisor_company_id: 106880
advisor_company_name: Simpson Thacher & Bartlett LLP
advisor_type_name: Legal Counsel
advisor_fee_amount: '1200000.0000'
advisor_fee_currency: USD
is_lead: false
summary: 'transaction id: 4299145'
description: Indicates a successful request.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/fundingrounds/investor/{company_id}:
get:
operationId: fundingrounds_investor_retrieve
description: Get the rounds of funding that the specified company invested in.
parameters:
- in: path
name: company_id
schema:
type: integer
required: true
security:
- cookieAuth: []
- Kensho_JWT_Auth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/RoundsOfFunding'
examples:
GetTheRoundsOfFundingThatTheSpecifiedCompanyBoughtInto.:
value:
rounds_of_funding:
- transaction_id: 444715
funding_round_notes: e-Builder, Inc. announced a strategic round of funding from new investor The McGraw-Hill
Companies, Inc. on May 1, 2000.
closed_date: '2000-05-01'
funding_type: Venture
- transaction_id: 383751
funding_round_notes: Gather, Inc. announced that it will raise $2,400,000 through the issuance of equity
shares on November 17, 2010. The securities will be issued pursuant to Regulation D.
closed_date: '2010-11-24'
funding_type: Series E
summary: 'company id: 21719'
description: Indicates a successful request.
'403':
description: Indicates that the authorization information is missing or invalid.
/api/v1/fundingrounds/target/{company_id}:
get:
operationId: fundingrounds_target_retrieve
description: Get the rounds of funding that the specified company was in.
parameters:
- in: path
# --- truncated at 32 KB (240 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sp-global/refs/heads/main/openapi/kensho-llmready-openapi.yml