ncar.gov.sa APIncar.gov.sa ↗
Access Saudi regulations, international treaties, Um Al-Qura newspaper archives, and governmental coding data via the NCAR ncar.gov.sa API.
curl -X GET 'https://api.parse.bot/scraper/76b4a511-4473-467d-a219-faaf36adcc3e/search_rules_and_regulations?page=1&limit=10&sort_order=DESC&sort_column=IsTranslated' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for Saudi rules and regulations with pagination and sorting.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number |
| limit | integer | Number of results per page |
| sort_order | string | Sort order (ASC/DESC) |
| sort_column | string | Column to sort by |
{
"type": "object",
"fields": {
"data": "array",
"status": "integer",
"messages": "array",
"dataLength": "integer"
},
"sample": {
"data": {
"data": [
{
"id": "eyJpdiI6ImxZTUk3V3Vnci9zZlBwS05vbjZIYkE9PSIsInZhbHVlIjoiOTJZNC9LeThGYjVnUktlQi9XQkJkUT09IiwibWFjIjoiM2E2OTVlYmEwMTM5NzNmZTZlYzMzZjZlODAzNjM2MzQxODFkMWNmNDhlOTM3YWRmNTRhMDY4ZmI0MTE2MmZmNCIsInRhZyI6IiJ9",
"marker": {
"class": "valid",
"title_ar": "الوثيقة سارية",
"title_en": "The document is valid"
},
"number": "أ/164",
"status": "2",
"checked": false,
"Approves": [
{
"id": 1,
"name_ar": "أمر ملكي",
"name_en": "Royal Order",
"TypeOrder": "1",
"approve_date": "١٤٢٨/٠٩/٢٦"
}
],
"is_valid": "سارية",
"title_ar": "اللائحة التنفيذية لنظام هيئة البيعة لعام 1428هـ",
"title_en": "Implementing Regulations of the Succession Commission Law 2007M",
"is_latest": 0,
"approve_date": "١٤٢٨/٠٩/٢٦",
"IsGovernmental": 0,
"PublishingStatus": 1
},
{
"id": "eyJpdiI6IjdHbG1GNjdEMzRlaGx6TGY1Q21GQnc9PSIsInZhbHVlIjoiNE83d2NzeXFjb09oajlNUkpGK0FPQT09IiwibWFjIjoiNDMzOWM5MjVjMDE5ZTE5ZGRmZTMzMGRiM2RhYjViZDNjOWNiNWI2ZGExZmE0OGE5ZWJiMjc5MzRiMmNmNzhlNyIsInRhZyI6IiJ9",
"marker": {
"class": "valid-modified",
"title_ar": "الوثيقة سارية ومعدلة",
"title_en": "The document is valid and amended"
},
"number": "م/3",
"status": "2",
"checked": false,
"Approves": [
{
"id": 2,
"name_ar": "مرسوم ملكي",
"name_en": "Royal Decree",
"TypeOrder": "2",
"approve_date": "١٣٩٣/٠٢/١٠"
}
],
"is_valid": "سارية",
"title_ar": "نظام العلم للمملكة العربية السعودية لعام 1393هـ",
"title_en": "Flag Law of the Kingdom of Saudi Arabia for the year 1973",
"is_latest": 0,
"approve_date": "١٣٩٣/٠٢/١٠",
"IsGovernmental": 0,
"PublishingStatus": 1
},
{
"id": "eyJpdiI6ImVaZkhGU3dyYURNcFhwRndVOXR1Nnc9PSIsInZhbHVlIjoiMWhjWk1yMlUzV1JxUHZDbUxHaG0vQT09IiwibWFjIjoiMTRkZWM5ODE5NjVhYWM5NzhkMmE3NTU4YjJmNGExZmI2YWU5Y2UzZmRhOGRmMTBhNzIzZjg4YWYzOTZhNDhhYiIsInRhZyI6IiJ9",
"marker": {
"class": "valid",
"title_ar": "الوثيقة سارية",
"title_en": "The document is valid"
},
"number": "أ/135",
"status": "2",
"checked": false,
"Approves": [
{
"id": 1,
"name_ar": "أمر ملكي",
"name_en": "Royal Order",
"TypeOrder": "1",
"approve_date": "١٤٢٧/٠٩/٢٦"
}
],
"is_valid": "سارية",
"title_ar": "نظام هيئة البيعة لعام 1427هـ",
"title_en": "Succession Commission Law 1427H",
"is_latest": 0,
"approve_date": "١٤٢٧/٠٩/٢٦",
"IsGovernmental": 0,
"PublishingStatus": 1
}
],
"status": 1,
"messages": 0,
"dataLength": 6621
},
"status": "success"
}
}About the ncar.gov.sa API
This API exposes 7 endpoints covering Saudi Arabia's official governmental document repository at ncar.gov.sa, including rules and regulations, international conventions and treaties, Um Al-Qura newspaper archives, and administrative coding hierarchies. The global_search endpoint lets you query across all content types in a single call, while dedicated endpoints like search_rules_and_regulations and get_regulation_details give structured access to individual legislative documents by encrypted document ID.
Regulations and Conventions
search_rules_and_regulations accepts page, limit, sort_order, and sort_column parameters, returning a paginated data array alongside a dataLength integer that reflects the total result count. Once you have a document identifier from that listing, get_regulation_details takes the encrypted doc_id and returns a single data object with the full record for that regulation or convention. search_conventions_and_treaties follows the same pagination and sorting interface and also exposes a dataLength field, making it straightforward to build paginated clients that walk the full treaty catalog.
Um Al-Qura Newspaper Archive
search_um_alqura_newspaper provides access to issues of the Saudi official gazette, Um Al-Qura, with page, limit, and sort_order controls. The endpoint returns a data array of matching issues and a dataLength count. This is useful for locating historical gazette entries that published royal decrees, ministerial decisions, or official announcements.
Governmental and Regional Coding
get_regions_coding requires no input parameters and returns the full hierarchy of Saudi administrative regions as a data array. get_governmental_coding accepts an optional name string to filter results by agency name, returning matching governmental entity records. Both endpoints return a status integer alongside their data payloads.
Global Search
The global_search POST endpoint accepts a query string and returns a data object that spans all content types — regulations, treaties, newspaper issues, and coding records — in a single response. This is useful when the content type is unknown or when building a unified search interface over NCAR's document holdings.
- Build a compliance tool that retrieves current Saudi regulations by keyword using
search_rules_and_regulationsandget_regulation_details. - Aggregate Saudi international treaty data for legal research by paginating through
search_conventions_and_treatiesresults. - Index historical Um Al-Qura newspaper issues for archival or journalistic research using
search_um_alqura_newspaper. - Map Saudi administrative region hierarchies for geospatial or logistics applications using
get_regions_coding. - Look up governmental entity codes by agency name with
get_governmental_codingto validate or enrich government procurement records. - Power a unified document search interface over NCAR holdings using the
global_searchendpoint with a single query string. - Monitor newly published regulations by polling
search_rules_and_regulationswithsort_order=DESCsorted by publication date.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ncar.gov.sa offer an official developer API?+
What does `get_regulation_details` return compared to the search endpoints?+
get_regulation_details returns a single data object with the full detail record for one document, identified by its encrypted doc_id. The search endpoints — search_rules_and_regulations and search_conventions_and_treaties — return data arrays of summary records with a dataLength count, intended for listing and pagination rather than full document retrieval.Can I filter Um Al-Qura newspaper results by date range or issue number?+
search_um_alqura_newspaper currently accepts page, limit, and sort_order parameters only — there is no date-range or issue-number filter parameter exposed. You can fork this API on Parse and revise it to add a date or issue filter endpoint if your use case requires it.Does the API return the full text or PDF content of regulations?+
How does pagination work across the listing endpoints?+
search_rules_and_regulations, search_conventions_and_treaties, and search_um_alqura_newspaper endpoints all accept page and limit integer parameters. Each response includes a dataLength integer representing the total number of matching records, which you can use to calculate total page counts client-side.