Fundamentals Layer API (Production)
Get historical financial statements for a company
Returns the reported financial statement history for the company across fiscal periods. Use fromYear/toYear or numberOfYear to bound the range.
get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/financials/history
Query Parameters
yearinteger(int32)
Calendar year to filter by, e.g. 2025.
Example:2023
marketIdinteger(int32)
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values. Defaults to 3.
Default:3
Example:3
periodstring
Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.
Default:year
Example:year
fiscalPeriodstring
Fiscal period within the year: 1-4 for quarters, 5 for the full year.
Default:
Example:year
Path Parameters
stockSymbolstringrequired
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Response
200 application/json
Response
200 application/json
Success
ApiV1Response
* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/financials/history
Authentication
Path Parameters
Query Parameters
200 application/json
Get reports for a company
Returns the reports for the company identified by stockSymbol.
get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/financials/reports
Query Parameters
marketIdinteger(int32)
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values. Defaults to 3.
Default:3
Example:3
Path Parameters
stockSymbolstringrequired
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Response
200 application/json
Response
200 application/json
Success
ApiV1Response
* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/financials/reports
Authentication
Path Parameters
Query Parameters
200 application/json
Get financial ratios for a company
Returns the financial ratios for the company identified by stockSymbol.
get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/ratios
Query Parameters
marketIdinteger(int32)
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
periodstring
Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.
Default:year
Example:year
Path Parameters
stockSymbolstringrequired
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Response
200 application/json
Response
200 application/json
Success
ApiV1Response
* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/ratios
Authentication
Path Parameters
Query Parameters
200 application/json
Get historical series for a company
Returns the historical series for the company identified by stockSymbol.
get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/ratios/history
Query Parameters
yearinteger(int32)
Calendar year to filter by, e.g. 2025.
Example:2023
marketIdinteger(int32)
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
periodstring
Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.
Default:year
Example:year
fiscalPeriodstring
Fiscal period within the year: 1-4 for quarters, 5 for the full year.
Default:
Example:year
Path Parameters
stockSymbolstringrequired
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Response
200 application/json
Response
200 application/json
Success
ApiV1Response
* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/ratios/history
Authentication
Path Parameters
Query Parameters
200 application/json
Get key financial highlights for a company
Returns the key financial highlights for the company identified by stockSymbol.
get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/highlights
Query Parameters
marketIdinteger(int32)
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
Path Parameters
stockSymbolstringrequired
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Response
200 application/json
Response
200 application/json
Success
ApiV1Response
* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/highlights
Authentication
Path Parameters
Query Parameters
200 application/json