---
title: "Regulatory Filings Layer API"
url: "https://developer.argaam.com/apis/regulatory-filings-layer-api-production-v1/versions/25d382bc-ccdc-4bdb-9ea0-7a2689298b49"
---

# Regulatory Filings Layer API

OpenAPI specification document.

````json
{"openapi":"3.0.1","info":{"title":"Regulatory Filings Layer API","description":"Regulatory and offering documents: IPOs by market, IPO details, and prospectus documents.","contact":{"name":"Argaam IT","url":"https://www.argaam.com","email":"developer@argaam.com"},"version":"v1.1"},"paths":{"/api/v1.1/ipos/markets/{marketId}":{"get":{"tags":["Ipos"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Market ID.","example":3}],"responses":{"200":{"description":"Success"}},"summary":"List IPOs in a market.","description":"Returns the IPO calendar for the requested market: upcoming,\r\nactive subscription, and recently listed offerings.\r\n            \r\n### Example\r\n```\r\nGET /api/v1.1/ipos/markets/1\r\n```","operationId":"getIposMarketsByMarketId"}},"/api/v1.1/ipos/markets/{marketId}/companies/{stockSymbol}/ipos/{ipoId}/details":{"get":{"tags":["Ipos"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3},{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"ipoId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"IPO identifier, scoped to the given market and company."}],"responses":{"200":{"description":"Success"}},"summary":"Get details for a market","description":"Returns the details for the market identified by `marketId`.","operationId":"getIposMarketsByMarketIdCompaniesByStockSymbolIposByIpoIdDetails"}},"/api/v1.1/ipos/markets/{marketId}/companies/{stockSymbol}/ipos/{ipoId}/prospectus":{"get":{"tags":["Ipos"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3},{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"ipoId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"IPO identifier, scoped to the given market and company."}],"responses":{"200":{"description":"Success"}},"summary":"Get an IPO prospectus","description":"Returns the prospectus document metadata and content links for the IPO.","operationId":"getIposMarketsByMarketIdCompaniesByStockSymbolIposByIpoIdProspectus"}}},"components":{"schemas":{},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey"},"ApiKeyAuthQuery":{"type":"apiKey","in":"query","name":"apikey"}}},"security":[{"ApiKeyAuth":[]}],"servers":[{"url":"https://api.argaam.com","description":"Argaam API Gateway (Production)"}]}
````