openapi: 3.2.0
info:
title: Financial Data API
description: The **Financial Data APIs**, a RESTful service on 73 Strings, allows to retrieve comprehensive information of attributes and their values on various cash flow dates in several tags of the Financials, that belongs to a company in the funds across the organization in the 73 Strings platform.
contact:
name: ''
email: support@73strings.com
license:
name: Apache 2.0
url: http://www.apache.org/licenses/LICENSE-2.0.html
version: '1.0'
servers:
- url: https://api-accord-eut-73strings.azure-api.net/financial-data
security:
- {}
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: Financial Data
description: The **Financial Data APIs**, a RESTful service on 73 Strings, allows to retrieve comprehensive information of attributes and their values on various cash flow dates in several tags of the Financials, that belongs to a company in the funds across the organization in the 73 Strings platform.
paths:
/api/v1/data/getAllFinancialTexts:
post:
operationId: getAllFinancialTexts
summary: Get All Financial Texts
tags:
- Financial Data
description: Retrieves textual values of financial attributes (e.g., statements, KPIs) for specified companies, segments, securities, and versions, across given cash flow dates or date ranges.
parameters:
- name: subscription-key
in: header
required: true
description: A unique key that allows you to access and use the API.
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GetAllFinancialTextsReq'
examples:
default:
value:
userId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
data:
- attributeId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
companyId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
segmentId: null
versionId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
periodType: Quarterly
startDate: '2024-12-01'
endDate: '2025-12-31'
asOfDate: '2025-07-08'
- attributeId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
companyId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
segmentId: null
securityId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
versionId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
periodType: Annual
startDate: '2024-12-01'
endDate: '2025-12-31'
asOfDate: '2025-07-08'
- attributeId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
companyId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
segmentId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
versionId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
periodType: Quarterly
cashFlowDate: 30-09-2023
startDate: '2022-12-01'
endDate: '2024-12-11'
asOfDate: '2025-03-12'
description: Request payload containing userId and financial text data details.
responses:
'200':
description: Successful retrieval of financial texts.
content:
application/json:
schema:
$ref: '#/components/schemas/GetAllFinancialTextsResp'
examples:
default:
value:
response:
data:
- attributeId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
attributeName: Test Attribute CL
tag: Income Statement
companyId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
companyName: Testing Company
versionId: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
versionName: Actual
periodType: Quarterly
cashFlowDate: 30-09-2023
startDate: '2024-12-01'
endDate: '2025-12-31'
asOfDate: '2025-07-08'
textValue: Ten thousand
segments:
- {}
errorCodes:
- {}
success: true
message: Success
errorCode: null
'400':
description: Invalid request parameters.
'401':
description: Invalid or missing subscription key.
'500':
description: Internal server error.
/api/v1/ems/entityBuFinancialData:
post:
operationId: entityBuFinancialData
summary: Get BU Financial Data
tags:
- Financial Data
description: 'The BU Financial Data API retrieves the financial data for a specific business unit belonging to an entity of type "company." This API returns all data points available in the Financial table for the requested business unit, for the numerical category attributes as entered by users for different reporting periods and cashflow dates.
The endpoint enables clients to access structured, period-based financial information, supporting detailed analysis using both aggregated value and its drill down data for business units within a company. '
parameters:
- name: subscription-key
in: header
required: true
description: A unique key that allows you to access and use an API
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EntityBuFinancialDataReqDTO'
examples:
default:
value:
attributeNames: []
entityIds:
- 2e6f3220-7d22-4e99-829c-87221b4e8119
- sdfsfdsfdsf
companyName: ''
asOfDate: ''
currency: EUR
units: Millions
versionId: ''
versionName: Budget
startDate: '2020-07-04'
endDate: '2030-07-04'
orgId: 8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4
periodType: Annual
userId: 4d32666b-5fa9-489f-93b1-1f5036bd2a41
businessUnitIds:
- 41eba2d2-4418-488d-aed6-a7b4be1905ec
- 9728aad5-6f1b-43d9-a6f1-ab005817768b
- asdsad
- asdasdasd
includeDrillDown: 'false'
description: Request payload containing entity Bu financial attribute names, entity ids, company details, currency, time period, business unit ids and include drilldown for retrieving entity bu financial data.
responses:
'200':
description: Successful retrieval of financial data of attributes.
content:
application/json:
schema:
$ref: '#/components/schemas/EntityBuFinancialDataResDTO'
examples:
Success Example:
description: Success Example
value:
response:
financialPowerBiResponseDTO:
- orgId: 8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4
companyId: 2e6f3220-7d22-4e99-829c-87221b4e8119
companyName: Tesla
version: Budget
period: Annual
tag: Income Statement
units: Millions
currency: EUR
attributeId: 2265d855-d2d2-43ae-b6b7-838f1c05c301
attributeName: Employee Benefit*
cashFlowDate: '2023-12-31T12:00:00Z'
asOfDate: '2025-06-18T12:00:00Z'
businessUnitId: 41eba2d2-4418-488d-aed6-a7b4be1905ec
businessUnitName: BU 1
trueUpValue: 24.585781
drillDown: null
cellTypeData: null
- orgId: 8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4
companyId: 2e6f3220-7d22-4e99-829c-87221b4e8119
companyName: Tesla
version: Budget
period: Annual
tag: Income Statement
units: Millions
currency: EUR
attributeId: 2265d855-d2d2-43ae-b6b7-838f1c05c301
attributeName: Employee Benefit*
cashFlowDate: '2024-12-31T12:00:00Z'
asOfDate: '2025-06-18T12:00:00Z'
businessUnitId: 41eba2d2-4418-488d-aed6-a7b4be1905ec
businessUnitName: BU 1
trueUpValue: 32.735337
drillDown: null
cellTypeData: null
errors:
- success: false
message: 'Invalid entity id: [sdfsfdsfdsf]'
responseCode: BAD_REQUEST
- success: false
message: 'Invalid businessUnit ids: [asdsad, asdasdasd]'
responseCode: BAD_REQUEST
success: true
message: Success
errorCode: null
No Data Example:
description: No Data Example
value:
response: []
success: false
message: Data not found.
errorCode: EXCE00021
'202':
description: Request accepted for processing, but not yet completed.
content:
application/json:
examples:
Accepted Example:
description: Accepted Example
value:
response: []
success: true
message: Request accepted and is being processed.
errorCode: null
'400':
description: Invalid input, missing parameters.
content:
application/json:
examples:
Bad Request Example:
description: Bad Request Example
value:
response: []
success: false
message: Invalid request parameters.
errorCode: EXCE00028
Required Fields Can't Be Null Or Empty Example:
description: Required Fields Can't Be Null Or Empty Example
value:
response: []
success: false
message: Fields cannot be null or empty..
errorCode: EXCE00020
'401':
description: Invalid or missing Subscription key.
content:
application/json:
examples:
Invalid Subscription key Example:
description: Invalid Subscription key Example
value:
statusCode: 401
message: Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription.
'405':
description: 'Request with incorrect HTTPS method. '
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
examples:
Method not allowed Example:
description: Method not allowed Example
value:
statusCode: 405
message: Method Not Allowed. Please use the correct HTTP method.
'429':
description: Too many requests sent in a short period. The client is being rate limited.
content:
application/json:
examples:
Too Many Request Example.:
description: Too Many Request Example.
value:
statusCode: 429
message: Too Many Requests. Please slow down and try again later.
'500':
description: Internal server error.
content:
application/json:
examples:
Internal Server Error Example:
description: Internal Server Error Example
value:
statusCode: 500
message: Internal server error. Please try again later or contact support.
/api/v1/ems/entityFinancialData:
post:
operationId: entityFinancialData
summary: Get Entity Financial Data
tags:
- Financial Data
description: 'The 73 Monitor lets users add data of financial statements and other KPIs (Key Performance Indicators) of an entity, which are useful for valuating the entities and also keep a track of their growth especially for fund managers and analysts. The Entity Financial Data API retrieves aggregated financial data (numerical only) as well as its breakdown for specified attributes across multiple entities. Users can request data for a list of entities, and the API will return the aggregated and drilldown values for each attribute across various tags of the financials. such as Income Statement, Balance Sheet, Cash Flows and many more.
The retrieved financial data includes detailed information for each cashflow date, providing a comprehensive view of financial performance over time.'
parameters:
- name: subscription-key
in: header
required: true
description: A unique key that allows you to access and use an API
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EntityFinancialsReqDTO'
examples:
default:
value:
attributeNames:
- Revenue*
- Marketing Expenses*
- xcvdfbv
entityIds:
- 2e6f3220-7d22-4e99-829c-87221b4e8119
companyName: ''
asOfDate: ''
currency: EUR
units: Millions
versionId: ''
versionName: Budget
startDate: '2020-07-04'
endDate: '2030-07-04'
orgId: 8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4
periodType: Annual
userId: 4d32666b-5fa9-489f-93b1-1f5036bd2a41
includeDrillDown: 'false'
description: Request payload containing entity financial attribute names, entity ids, company details, currency, time period and include drilldown for retrieving entity financial data.
responses:
'200':
description: Successful retrieval of financial data of attributes.
content:
application/json:
schema:
$ref: '#/components/schemas/EntityFinancialResDTO'
examples:
Success Example:
description: Success Example
value:
response:
financialPowerBiResponseDTO:
- orgId: 8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4
companyId: 2e6f3220-7d22-4e99-829c-87221b4e8119
companyName: Tesla
version: Budget
period: Annual
tag: Income Statement
units: Millions
currency: EUR
attributeId: 70f49a71-746e-11ec-a730-249684d39778
attributeName: Revenue*
cashFlowDate: '2020-12-31T12:00:00Z'
asOfDate: '2025-06-18T12:00:00Z'
trueUpValue: 1558.822453
drillDown: null
cellTypeData: null
- orgId: 8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4
companyId: 2e6f3220-7d22-4e99-829c-87221b4e8119
companyName: Tesla
version: Budget
period: Annual
tag: Income Statement
units: Millions
currency: EUR
attributeId: 70f49a71-746e-11ec-a730-249684d39778
attributeName: Revenue*
cashFlowDate: '2021-12-31T12:00:00Z'
asOfDate: '2025-06-18T12:00:00Z'
trueUpValue: 1948.528067
drillDown: null
cellTypeData: null
errors: []
success: true
message: Success
errorCode: null
No Data Example:
description: No Data Example
value:
response: []
success: false
message: Data not found.
errorCode: EXCE00021
'202':
description: Request accepted for processing, but not yet completed.
content:
application/json:
examples:
Accepted Example:
description: Accepted Example
value:
response: []
success: true
message: Request accepted and is being processed.
errorCode: null
'400':
description: Invalid input, missing parameters.
content:
application/json:
examples:
Bad Request Example:
description: Bad Request Example
value:
response: []
success: false
message: Invalid request parameters.
errorCode: EXCE00028
Required Fields Can't Be Null Or Empty Example:
description: Required Fields Can't Be Null Or Empty Example
value:
response: []
success: false
message: Fields cannot be null or empty..
errorCode: EXCE00020
'401':
description: Invalid or missing Subscription key.
content:
application/json:
examples:
Invalid Subscription key Example:
description: Invalid Subscription key Example
value:
statusCode: 401
message: Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription.
'405':
description: 'Request with incorrect HTTPS method. '
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
examples:
Method not allowed Example:
description: Method not allowed Example
value:
statusCode: 405
message: Method Not Allowed. Please use the correct HTTP method.
'429':
description: Too many requests sent in a short period. The client is being rate limited.
content:
application/json:
examples:
Too Many Request Example.:
description: Too Many Request Example.
value:
statusCode: 429
message: Too Many Requests. Please slow down and try again later.
'500':
description: Internal server error.
content:
application/json:
examples:
Internal Server Error Example:
description: Internal Server Error Example
value:
statusCode: 500
message: Internal server error. Please try again later or contact support.
/api/v2/ems/entityFinancialData:
post:
operationId: streamEntityFinancialData
summary: Get Entity Financial Data V2
tags:
- Financial Data
description: 'The Entity Financial Data API retrieves aggregated financial data (numerical only) as well as its breakdown for specified attributes across multiple entities. This endpoint uses Server-Sent Events (SSE) to stream financial data records in real-time, making it efficient for large datasets.
## Streaming Response Format
```
data: {\"orgId\": \"8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4\", \"companyName\": \"Tesla\", ...}\n\n
data: {\"orgId\": \"8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4\", \"companyName\": \"Tesla\", ...}\n\n
```
Each line starting with `data: ` contains a JSON object with financial data. Clients should parse these as individual records.
⚠️ **Concurrency Limitation**
This API does not support concurrent streaming sessions. Simultaneous requests from the same client will result in undefined behavior or connection failures. Ensure that your implementation processes one stream at a time before initiating a new request.'
parameters:
- name: subscription-key
in: header
required: true
description: A unique key that allows you to access and use an API
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EntityFinancialsReqDTO'
examples:
default:
value:
attributeNames:
- Revenue*
- Marketing Expenses*
entityIds:
- 2e6f3220-7d22-4e99-829c-87221b4e8119
companyNames: null
asOfDate: '2025-08-13'
currency: EUR
units: Millions
versionId: 35cf6c3d-d4c7-4c76-af0c-239800e8a482
versionName: Budget
startDate: '2020-07-04'
endDate: '2030-07-04'
orgId: 8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4
periodType: Annual
userId: 4d32666b-5fa9-489f-93b1-1f5036bd2a41
includeDrillDown: false
description: Request payload containing entity financial attribute names, entity ids, company details, currency, time period and include drilldown for retrieving entity financial data.
responses:
'200':
description: Successful retrieval of financial data. Returns a stream of Server-Sent Events containing financial records.
content:
text/event-stream:
schema:
$ref: '#/components/schemas/ApiV2EmsEntityFinancialDataPost200TextEvent-streamResponse'
examples:
StreamExample:
description: Example SSE stream with multiple financial records
value: 'data: {"orgId": "8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4", "companyId": "2e6f3220-7d22-4e99-829c-87221b4e8119", "companyName": "Tesla", "version": "Budget", "period": "Annual", "tag": "Income Statement", "units": "Millions", "currency": "EUR", "attributeId": "70f49a71-746e-11ec-a730-249684d39778", "attributeName": "Revenue*", "cashFlowDate": "2020-12-31T12:00:00.0000000+00:00", "asOfDate": "2025-06-18T12:00:00.0000000+00:00", "trueUpValue": 1558.822453, "drillDown": null, "cellTypeData": null}
data: {"orgId": "8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4", "companyId": "2e6f3220-7d22-4e99-829c-87221b4e8119", "companyName": "Tesla", "version": "Budget", "period": "Annual", "tag": "Income Statement", "units": "Millions", "currency": "EUR", "attributeId": "70f49a71-746e-11ec-a730-249684d39779", "attributeName": "Marketing Expenses*", "cashFlowDate": "2020-12-31T12:00:00.0000000+00:00", "asOfDate": "2025-06-18T12:00:00.0000000+00:00", "trueUpValue": 245.5, "drillDown": null, "cellTypeData": null}
'
headers:
Content-Type:
description: ''
schema:
type: string
Cache-Control:
description: ''
schema:
type: string
Connection:
description: ''
schema:
type: string
'202':
description: Request accepted for processing, but not yet completed.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
examples:
AcceptedExample:
description: Accepted Example
value:
response: []
success: true
message: Request accepted and is being processed.
errorCode: null
'400':
description: Invalid input, missing parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
examples:
BadRequestExample:
description: Bad Request Example
value:
response: []
success: false
message: Invalid request parameters.
errorCode: EXCE00028
'401':
description: Invalid or missing Subscription key.
content:
application/json:
examples:
InvalidSubscriptionKey:
description: Invalid Subscription key Example
value:
statusCode: 401
message: Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription.
'405':
description: Request with incorrect HTTPS method.
content:
application/json:
examples:
MethodNotAllowed:
description: Method not allowed Example
value:
statusCode: 405
message: Method Not Allowed. Please use the correct HTTP method.
'429':
description: Too many requests sent in a short period. The client is being rate limited.
content:
application/json:
examples:
TooManyRequests:
description: Too Many Request Example
value:
statusCode: 429
message: Too Many Requests. Please slow down and try again later.
'500':
description: Internal server error.
content:
application/json:
examples:
InternalServerError:
description: Internal Server Error Example
value:
statusCode: 500
message: Internal server error. Please try again later or contact support.
/api/v1/ems/entitySecurityFinancialData:
post:
operationId: entitySecurityFinancialData
summary: Get Security Financial Data
tags:
- Financial Data
description: 'The Security Financial Data API retrieves the financial data for a specific securities belonging to an entity of type "company." This API returns all data points available in the Financial table for the requested security, for the numerical category attributes as entered by users for different reporting periods and cashflow dates.
The endpoint enables clients to access structured, period-based financial information, supporting detailed analysis using both aggregated value and its drill down data for securities within a company. '
parameters:
- name: subscription-key
in: header
required: true
description: A unique key that allows you to access and use an API
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EntitySecurityFinancialDataReqDTO'
examples:
default:
value:
attributeNames:
- Revenue*
- Marketing Expenses*
- xcvdfbv
entityIds:
- 2e6f3220-7d22-4e99-829c-87221b4e8119
companyName: ''
asOfDate: ''
currency: EUR
units: Millions
versionId: ''
versionName: Budget
startDate: '2020-07-04'
endDate: '2030-07-04'
orgId: 8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4
periodType: Annual
userId: 4d32666b-5fa9-489f-93b1-1f5036bd2a41
securityIds:
- 3965b88a-09c5-4ecd-871b-7b0a743b781a
- sdfsdf
- sdfdsf
includeDrillDown: 'false'
description: Request payload containing entity Security financial attribute names, entity ids, company details, currency, time period and security ids for retrieving entity security financial data.
responses:
'200':
description: Successful retrieval of financial data of attributes.
content:
application/json:
schema:
$ref: '#/components/schemas/EntitySecurityFinancialDataResDTO'
examples:
Success Example:
description: Success Example
value:
response:
financialPowerBiResponseDTO:
- orgId: 8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4
companyId: 2e6f3220-7d22-4e99-829c-87221b4e8119
companyName: Tesla
version: Budget
period: Annual
tag: Income Statement
units: Millions
currency: EUR
attributeId: 70f49a71-746e-11ec-a730-249684d39778
attributeName: Revenue*
cashFlowDate: '2023-12-31T12:00:00Z'
asOfDate: '2025-06-18T12:00:00Z'
securityId: 3965b88a-09c5-4ecd-871b-7b0a743b781a
securityName: Sec Ps - 01
trueUpValue: 431.395186
drillDown: null
cellTypeData: null
- orgId: 8b8fce2c-e9c9-486a-b3f9-d881f3cda3d4
companyId: 2e6f3220-7d22-4e99-829c-87221b4e8119
companyName: Tesla
version: Budget
period: Annual
tag: Income Statement
units: Millions
currency: EUR
attributeId: 70f49a71-746e-11ec-a730-249684d39778
attributeName: Revenue*
cashFlowDate: '2024-12-31T12:00:00Z'
asOfDate: '2025-06-18T12:00:00Z'
securityId: 3965b88a-09c5-4ecd-871b-7b0a743b781a
securityName: Sec Ps - 01
trueUpValue: 253.75885
drillDown: null
cellTypeData: null
errors:
- success: false
message: 'Invalid security ids: [sdfsdf, sdfdsf]'
responseCode: BAD_REQUEST
- success: false
message: 'Invalid attribute name: [XCVDFBV]'
responseCode: BAD_REQUEST
success: true
message: Success
errorCode: null
# --- truncated at 32 KB (66 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/73-strings/refs/heads/main/openapi/73-strings-financial-data-api-openapi.yml