Fundamentals Layer API (Sandbox)

Fundamentals Layer API

Get financial results for a specific company within a market.

Returns the published financial statement results for a single company
within the market context, for the specified fiscal year and period.

This is a scoped version of GET /markets/{marketId}/financial-results
that narrows to one company without needing to filter client-side.

Period values — year (default), quarter, interim.

Tip: For the structured financial statement (income statement,
balance sheet) for a company use
GET /companies/{companyId}/financials/history?year={year}.

get
https://api-sandbox.argaam.com/api/v1.1/markets/{marketId}/financial-results/{stockSymbol}

Query Parameters

yearinteger(int32)

Calendar year to filter by, e.g. 2025.

Example:2023

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

marketIdinteger(int32)required

Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.

Example:3

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

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/markets/{marketId}/financial-results/{stockSymbol}
 
200 application/json

ApiV1Meta

object
* Additional properties are NOT allowed.
pageinteger(int32)
pageSizeinteger(int32)
totalRecordsinteger(int32)
totalPagesinteger(int32)read-only
hasNextPagebooleanread-only
hasPreviousPagebooleanread-only
Example

ApiV1RateLimit

object
* Additional properties are NOT allowed.
limitinteger(int32)
remaininginteger(int32)
resetstring(date-time)
Example

ApiV1Response

object
* Additional properties are NOT allowed.
successboolean
apiVersionstring
timestampstring(date-time)
requestIdstring
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
Example

ApiV1Response2

object

Standardized successful API response wrapper for v1.0.0 endpoints.

* Additional properties are NOT allowed.
successboolean

Always true for successful responses.

apiVersionstring

Semantic API version (e.g., “1.0.0”).

timestampstring(date-time)

UTC timestamp when the response was generated.

requestIdstring

Unique request identifier for tracing.

data

The response payload.

metaobject

Pagination and metadata information for collection responses.

* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject

Rate limit information returned with each response.

* Additional properties are NOT allowed.
Show Child Parameters
Example