---
title: "Regulatory Filings Layer API"
description: "Structured access to Tadawul and CMA disclosures: the filing index, extracted named sections, corporate actions, and the real-time disclosure feed."
url: "https://developer.argaam.com/filings-overview"
image: "https://developer.argaam.com/_og/d/c_Ocean.takumi,title_Regulatory+Filings+Layer+API,description_~U3RydWN0dXJlZCBhY2Nlc3MgdG8gVGFkYXd1bCBhbmQgQ01BIGRpc2Nsb3N1cmVzOiB0aGUgZmlsaW5nIGluZGV4LCBleHRyYWN0ZWQgbmFtZWQgc2VjdGlvbnMsIGNvcnBvcmF0ZSBhY3Rpb25zLCBhbmQgdGhlIHJlYWwtdGltZSBkaXNjbG9zdXJlIGZlZWQu,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiNGNTgwMjYifX19,p_Ii9maWxpbmdzLW92ZXJ2aWV3Ig,s_74P8CEpl0-FhfOGJ.png"
---

Overview

[Introduction](#overview)

Filings

[Search the filing index across Tadawul and CMA disclosuresGET](#get-api-v1-1-filings)[Get a single filing from the indexGET](#get-api-v1-1-filings-filingid)[Get the filing index for a companyGET](#get-api-v1-1-companies-stocksymbol-filings)[Get the list of disclosure types used in the filing indexGET](#get-api-v1-1-filings-types)[Get the extracted named sections of a filingGET](#get-api-v1-1-filings-filingid-sections)[Get one named section of a filingGET](#get-api-v1-1-filings-filingid-sections-sectionkey)[Get one extracted section across a company's filingsGET](#get-api-v1-1-companies-stocksymbol-filings-sections)

Corporate Actions

[Search corporate actions across the marketGET](#get-api-v1-1-corporate-actions)[Get a single corporate actionGET](#get-api-v1-1-corporate-actions-actionid)[Get corporate actions for a companyGET](#get-api-v1-1-companies-stocksymbol-corporate-actions)[Get the corporate action calendar for a marketGET](#get-api-v1-1-markets-marketid-corporate-actions)[Get the list of corporate action typesGET](#get-api-v1-1-corporate-actions-types)

Disclosures

[Get the disclosure index across the marketGET](#get-api-v1-1-disclosures)[Get the disclosure feed for a companyGET](#get-api-v1-1-companies-stocksymbol-disclosures)[Get the disclosure feed for a marketGET](#get-api-v1-1-markets-marketid-disclosures)

# Regulatory Filings Layer API

v1.1 CurrentOAS 3.0Production

[Plans](https://developer.argaam.com/plans)[Use this API](https://developer.argaam.com/apis/regulatory-filings-layer-api-production-v1/versions/25d382bc-ccdc-4bdb-9ea0-7a2689298b49)

⚠

**Proposed family.** This family is named on the live portal but its product page was not among the catalogue pages supplied, so the operations below are proposed against the observed v1.1 contract rather than transcribed. Confirm before publishing.

Structured access to Tadawul and CMA disclosures: the filing index, extracted named sections, corporate actions, and the real-time disclosure feed.

API base URL

https://api.argaam.com

Argaam API Gateway (Production)

Security

`ApiKeyAuth` — apikey header

`ApiKeyAuthQuery` — apikey query parameter

✉

**Additional information.** Contact Argaam IT — [developer@argaam.com](mailto:developer@argaam.com)

### [Search the filing index across Tadawul and CMA disclosures](#search-the-filing-index-across-tadawul-and-cma-disclosures)

Returns a paged index of the disclosures filed with the Saudi Exchange and the CMA, newest first, each record carrying the issuer, the disclosure type, the source and the publication time. Use marketId to scope to TASI or Nomu and period to bound the window.

GEThttps://api.argaam.com/api/v1.1/filings

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

filingTypestring

pageinteger (int32)

Page of the result set to return.

Default: 1

pageSizeinteger (int32)

Number of records per page.

Default: 20

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/filings?marketId=3&period=year&page=1&pageSize=20&lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get a single filing from the index](#get-a-single-filing-from-the-index)

Returns the index record for one filing: its title, disclosure type, filing and publication timestamps, the issuer it belongs to and the links to the original Arabic and English documents.

GEThttps://api.argaam.com/api/v1.1/filings/{filingId}

Path parameters

filingIdstringrequired

Query parameters

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/filings/2026-0093418?lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get the filing index for a company](#get-the-filing-index-for-a-company)

Returns every disclosure filed by the company, newest first, across the depth of history Argaam holds for it. Use fiscalPeriod and year to pin the filings of a specific reporting period.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/filings

Path parameters

stockSymbolstringrequired

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

Example: 2222

Query parameters

fiscalPeriodstring

Fiscal period within the year: 1 - 4 for quarters, 5 for the full year.

Example: 5

yearinteger (int32)

Reporting or calendar year used to filter time-based data.

Example: 2023

pageinteger (int32)

Page of the result set to return.

Default: 1

pageSizeinteger (int32)

Number of records per page.

Default: 20

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/filings?fiscalPeriod=year&year=2023&page=1&pageSize=20&lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get the list of disclosure types used in the filing index](#get-the-list-of-disclosure-types-used-in-the-filing-index)

Returns the disclosure type taxonomy behind the index — board resolutions, material developments, periodic results, general assembly notices and the rest — with the Arabic and English label for each. These are the values accepted by filingType.

GEThttps://api.argaam.com/api/v1.1/filings/types

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/filings/types?marketId=3&lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get the extracted named sections of a filing](#get-the-extracted-named-sections-of-a-filing)

Returns the named sections Argaam extracts from the filing — reason for the announcement, effect on the financial statements, board recommendation, related party and the rest — as structured text, so a consumer never has to parse the Arabic PDF.

GEThttps://api.argaam.com/api/v1.1/filings/{filingId}/sections

Path parameters

filingIdstringrequired

Query parameters

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/filings/2026-0093418/sections?lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get one named section of a filing](#get-one-named-section-of-a-filing)

Returns a single extracted section identified by its key, carrying the Arabic source text as it was filed alongside the English rendering where one exists.

GEThttps://api.argaam.com/api/v1.1/filings/{filingId}/sections/{sectionKey}

Path parameters

filingIdstringrequired

sectionKeystringrequired

Query parameters

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/filings/2026-0093418/sections/{sectionKey}?lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get one extracted section across a company's filings](#get-one-extracted-section-across-a-companys-filings)

Returns the same named section pulled from each of the company's filings, so a single disclosed field can be tracked over time without opening the documents. Narrow the series with year and fiscalPeriod.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/filings/sections

Path parameters

stockSymbolstringrequired

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

Example: 2222

Query parameters

sectionKeystring

fiscalPeriodstring

Fiscal period within the year: 1 - 4 for quarters, 5 for the full year.

Example: 5

yearinteger (int32)

Reporting or calendar year used to filter time-based data.

Example: 2023

pageinteger (int32)

Page of the result set to return.

Default: 1

pageSizeinteger (int32)

Number of records per page.

Default: 20

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/filings/sections?fiscalPeriod=year&year=2023&page=1&pageSize=20&lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Search corporate actions across the market](#search-corporate-actions-across-the-market)

Returns a paged list of the corporate actions declared through Tadawul and CMA disclosures — dividends, capital increases and reductions, splits, mergers, suspensions and new listings — with their announcement, eligibility and payment dates.

GEThttps://api.argaam.com/api/v1.1/corporate-actions

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

actionTypestring

pageinteger (int32)

Page of the result set to return.

Default: 1

pageSizeinteger (int32)

Number of records per page.

Default: 20

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/corporate-actions?marketId=3&period=year&page=1&pageSize=20&lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get a single corporate action](#get-a-single-corporate-action)

Returns one corporate action in full, including the declared amounts and ratios, the key dates, its current status and a reference to the filing it was extracted from.

GEThttps://api.argaam.com/api/v1.1/corporate-actions/{actionId}

Path parameters

actionIdstringrequired

Query parameters

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/corporate-actions/{actionId}?lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get corporate actions for a company](#get-corporate-actions-for-a-company)

Returns the corporate actions declared by the company, newest first — dividend distributions, capital changes, splits and share suspensions — each linked back to the disclosure it came from. Use year to pin a single year.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/corporate-actions

Path parameters

stockSymbolstringrequired

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

Example: 2222

Query parameters

yearinteger (int32)

Reporting or calendar year used to filter time-based data.

Example: 2023

pageinteger (int32)

Page of the result set to return.

Default: 1

pageSizeinteger (int32)

Number of records per page.

Default: 20

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/corporate-actions?year=2023&page=1&pageSize=20&lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get the corporate action calendar for a market](#get-the-corporate-action-calendar-for-a-market)

Returns the corporate actions of every listed issuer in the market ordered by eligibility and payment date, which gives a forward calendar for TASI or Nomu. Use period to set the window.

GEThttps://api.argaam.com/api/v1.1/markets/{marketId}/corporate-actions

Path parameters

marketIdinteger (int32)required

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

Query parameters

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

actionTypestring

pageinteger (int32)

Page of the result set to return.

Default: 1

pageSizeinteger (int32)

Number of records per page.

Default: 20

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/markets/3/corporate-actions?marketId=3&period=year&page=1&pageSize=20&lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get the list of corporate action types](#get-the-list-of-corporate-action-types)

Returns the corporate action taxonomy with the Arabic and English label for each type. These are the values accepted by actionType.

GEThttps://api.argaam.com/api/v1.1/corporate-actions/types

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/corporate-actions/types?marketId=3&lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get the disclosure index across the market](#get-the-disclosure-index-across-the-market)

Returns the disclosures published across the market, newest first. Poll this collection with page and pageSize to keep a local copy of the index in step.

GEThttps://api.argaam.com/api/v1.1/disclosures

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

pageSizeinteger (int32)

Number of records per page.

Default: 20

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/disclosures?marketId=3&pageSize=20&lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get the disclosure feed for a company](#get-the-disclosure-feed-for-a-company)

Returns the company's disclosures in publication order, the single-issuer view of the feed that watchlist and alerting consumers follow. Use period to bound the window.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/disclosures

Path parameters

stockSymbolstringrequired

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

Example: 2222

Query parameters

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

pageinteger (int32)

Page of the result set to return.

Default: 1

pageSizeinteger (int32)

Number of records per page.

Default: 20

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/disclosures?period=year&page=1&pageSize=20&lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get the disclosure feed for a market](#get-the-disclosure-feed-for-a-market)

Returns every disclosure published in the market in publication order, scoped by marketId to TASI or Nomu and bounded by period.

GEThttps://api.argaam.com/api/v1.1/markets/{marketId}/disclosures

Path parameters

marketIdinteger (int32)required

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

Query parameters

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

pageinteger (int32)

Page of the result set to return.

Default: 1

pageSizeinteger (int32)

Number of records per page.

Default: 20

langstring

Language selector for multilingual output. Resolve the accepted value through the Languages mapping in the Knowledge Base.

Default: en · Example: en

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/markets/3/disclosures?marketId=3&period=year&page=1&pageSize=20&lang=en' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```