Fundamentals Layer API (Sandbox)

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-sandbox.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

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
 
200 application/json

Get reports for a company

Returns the reports for the company identified by stockSymbol.

get
https://api-sandbox.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

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
 
200 application/json

Get financial ratios for a company

Returns the financial ratios for the company identified by stockSymbol.

get
https://api-sandbox.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

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
 
200 application/json

Get historical series for a company

Returns the historical series for the company identified by stockSymbol.

get
https://api-sandbox.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

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
 
200 application/json

Get key financial highlights for a company

Returns the key financial highlights for the company identified by stockSymbol.

get
https://api-sandbox.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

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
 
200 application/json