Decree API

Decree API Overview

Decree API provides programmatic access to Decree Risk data to enable developers to build powerful applications that leverage liquidation notices and corporate dissolution announcements to enable businesses to take rapid action to recover their unpaid dues.

Under Omani law, when a company enters into liquidation, a notice declaring the commencement of the liquidation process and the names and contact details of the liquidator must be published. Creditors are required to file a claim to the liquidator within a maximum period of six months from the announcement date. If this deadline is missed, the creditors lose their right to claim the unpaid dues.

Decree API allows banks, utility companies, and other organisations that deal with Omani companies to build applications that automate the process of recovering unpaid loans, bills, and other debts from liquidated Omani companies by using Decree Risk data.

Decree API is a REST API that requires an API key for authentication. You can learn more about the fees for obtaining an API key by contacting us.

Announcement Types: By default, the API returns only the following announcement types:

Liquidation Start - Notice of commencement of liquidation proceedings
Liquidation End - Notice of completion of liquidation proceedings
Dissolution and Merger - Company dissolution or merger announcements

Authentication

Include your API key in every request using the X-API-Key header:

X-API-Key: your-api-key-here

Rate Limiting: Each API key is limited to 1,000 requests per day. Rate limit information is included in response headers:

X-RateLimit-Limit: Maximum requests per day
X-RateLimit-Remaining: Requests remaining in current window
X-RateLimit-Reset: When the rate limit resets (ISO 8601 timestamp)

Endpoints

GET /announcements/recent

Retrieve the most recent liquidation and dissolution announcements ordered by publication sequence. By default, only returns announcements of type "Liquidation Start", "Liquidation End", and "Dissolution and Merger".

Query Parameters

Parameter	Type	Required	Description
`limit`	integer	Optional	Number of announcements to return. Default: 500, Min: 1, Max: 10,000
`types`	array	Optional	Array of announcement types to filter by. Default: ["Liquidation Start", "Liquidation End", "Dissolution and Merger"]

Example Request

curl -H "X-API-Key: your-api-key" \
  "https://api.decree.om/announcements/recent?limit=100"

Example Response

{
  "success": true,
  "results": [
    {
      "id": "aG0vY7nuuF584vHcFD0g",
      "announcementText": "إعلان عن انتهاء أعمال التصفية لشركة النوفل للمشاريع الرائدة - توصية يعلن راشد بن ناصر بن سيف النوفلي بصفته المصفي لشركة النوفل للمشاريع الرائدة - توصية، والمسجلة لدى أمانة السجل التجاري بالرقم ١٠٧٥٠٤٩، عن انتهاء أعمال التصفية وزوال الكيان القانوني للشركة. المصفي",
      "arabicName": "شركة النوفل للمشاريع الرائدة",
      "companyCr": "1075049",
      "englishName": "(AL NAWFAL FOR LEADING PROJECTS COMPANY)",
      "type": "Liquidation End",
      "sequence": 13568,
      "publication": "Official Gazette 1511",
      "publicationDate": "2023-12-17T00:00:00.000Z",
      "liquidatorArabic": "راشد بن ناصر بن سيف النوفلي",
      "liquidatorEnglish": "Rashid bin Nasser bin Saif Al Nawfali"
    },
    {
      "id": "kl89IBtLINOg4u7QOakF",
      "announcementText": "إعلان عن بدء أعمال التصفية لشركة بوزقندة للتجارة ش.م.م يعلن مكتب الملكي لتدقيق الحسابات أنه يقوم بتصفية شركة بوزقندة للتجارة ش.م.م, والمسجلة لدى أمانة السجل التجاري بالرقم ١٣١١٠٠٣، وللمصفي وحده حق تمثيل الشركة في التصفية أمام الغير, وعلى الجميع مراجعة المصفي في كافة الأمور التي تتعلق بأعمال الشركة على العنوان الآتي: ص.ب: ١٠٩٨ ر.ب: ٢١١ هاتف رقم: ٩٢٣٢٨٢٢٢ كما يدعو المصفي بموجب هذا الإعلان دائني الشركة للتقدم بادعاءاتهم ضد الشركة مدعمة بالمستندات الثبوتية على العنوان المذكور أعلاه, خلال ستة أشهر من تاريخ نشر هذا الإعلان، وعلى كل من عليه حقوق للشركة أن يؤديها للمصفي على العنوان المشار إليه. المصفي",
      "arabicName": "شركة بوزقندة للتجارة",
      "companyCr": "1311003",
      "englishName": "BOUZGANDA TRADING",
      "type": "Liquidation Start",
      "sequence": 13538,
      "publication": "Official Gazette 1511",
      "publicationDate": "2023-12-17T00:00:00.000Z",
      "liquidatorArabic": "مكتب الملكي لتدقيق الحسابات",
      "liquidatorEnglish": "Royal Auditing Office",
      "liquidatorTelephone": "92328222"
    }
  ],
  "count": 2,
  "limit": 100,
  "types": ["Liquidation Start", "Liquidation End", "Dissolution and Merger"]
}

GET /announcements/by-cr

Retrieve all liquidation and dissolution announcements for a specific company by their CR (Commercial Registration) number. By default, only returns announcements of type "Liquidation Start", "Liquidation End", and "Dissolution and Merger".

Query Parameters

Parameter	Type	Required	Description
`companyCr`	string	Required	The company's Commercial Registration number
`types`	array	Optional	Array of announcement types to filter by. Default: ["Liquidation Start", "Liquidation End", "Dissolution and Merger"]

Example Request

curl -H "X-API-Key: your-api-key" \
  "https://api.decree.om/announcements/by-cr?companyCr=1574051"

Example Response

{
  "success": true,
  "results": [
    {
      "id": "kl89IBtLINOg4u7QOakF",
      "announcementText": "إعلان عن بدء أعمال التصفية لشركة بوزقندة للتجارة ش.م.م يعلن مكتب الملكي لتدقيق الحسابات أنه يقوم بتصفية شركة بوزقندة للتجارة ش.م.م, والمسجلة لدى أمانة السجل التجاري بالرقم ١٣١١٠٠٣، وللمصفي وحده حق تمثيل الشركة في التصفية أمام الغير, وعلى الجميع مراجعة المصفي في كافة الأمور التي تتعلق بأعمال الشركة على العنوان الآتي: ص.ب: ١٠٩٨ ر.ب: ٢١١ هاتف رقم: ٩٢٣٢٨٢٢٢ كما يدعو المصفي بموجب هذا الإعلان دائني الشركة للتقدم بادعاءاتهم ضد الشركة مدعمة بالمستندات الثبوتية على العنوان المذكور أعلاه, خلال ستة أشهر من تاريخ نشر هذا الإعلان، وعلى كل من عليه حقوق للشركة أن يؤديها للمصفي على العنوان المشار إليه. المصفي",
      "arabicName": "شركة بوزقندة للتجارة",
      "companyCr": "1311003",
      "englishName": "BOUZGANDA TRADING",
      "type": "Liquidation Start",
      "sequence": 13538,
      "publication": "Official Gazette 1511",
      "publicationDate": "2023-12-17T00:00:00.000Z",
      "liquidatorArabic": "مكتب الملكي لتدقيق الحسابات",
      "liquidatorEnglish": "Royal Auditing Office",
      "liquidatorTelephone": "92328222"
    }
  ],
  "count": 1,
  "companyCr": "1311003",
  "types": ["Liquidation Start", "Liquidation End", "Dissolution and Merger"]
}

Response Structure

All successful API responses follow a consistent structure:

Top-Level Response Object

Field	Type	Description
`success`	boolean	Indicates if the request was successful (`true` for success, `false` for errors)
`results`	array	Array of announcement objects (present on success)
`count`	integer	Number of announcements returned in this response
`limit`	integer	The limit value used for this request (for /recent endpoint)
`companyCr`	string	The company CR queried (for /by-cr endpoint)
`types`	array	The announcement types used to filter results. Default: ["Liquidation Start", "Liquidation End", "Dissolution and Merger"]
`error`	string	Error message (only present when `success` is `false`)

Response Headers

In addition to the JSON body, each response includes important HTTP headers:

X-RateLimit-Limit: 1000 - Your daily request limit
X-RateLimit-Remaining: 987 - Requests remaining in current day
X-RateLimit-Reset: 2025-12-10T19:30:00.000Z - When your limit resets

Announcement Object Fields

Each announcement object in the results array contains the following fields. Fields marked with Required are always present, while Optional fields may be missing for some announcements.

Field	Type	Status	Description
`id`	string	Required	Description: Unique Firestore document identifier for this announcement. Example: "aG0vY7nuuF584vHcFD0g"
`companyCr`	string	Required	Description: Commercial Registration (CR) number issued by the Ministry of Commerce. This is the primary company identifier in Oman. Example: "1075049"
`englishName`	string	Required	Description: Official company name in English, typically in all uppercase. Example: "(AL NAWFAL FOR LEADING PROJECTS COMPANY)"
`arabicName`	string	Required	Description: Official company name in Arabic script. Example: "شركة النوفل للمشاريع الرائدة"
`type`	string	Required	Description: Category of the announcement. The API returns three types by default: "Liquidation Start" - Commencement of liquidation proceedings "Liquidation End" - Completion of liquidation proceedings "Dissolution and Merger" - Company dissolution or merger Example: "Liquidation Start"
`publication`	string	Required	Description: Source publication where the announcement was originally published. Example: "Official Gazette 1511"
`publicationDate`	string	Required	Description: Date when the announcement was published, in ISO 8601 format with UTC timezone. Example: "2023-12-17T00:00:00.000Z"
`announcementText`	string	Required	Description: Full text of the announcement in Arabic. Example: "إعلان عن بدء أعمال التصفية لشركة..."
`sequence`	integer	Required	Description: Sequential ordering number where higher values indicate more recent announcements. Guarantees consistent ordering. Example: 13568
`liquidatorEnglish`	string	Optional	Description: Name of the appointed liquidator in English. Example: "Royal Auditing Office"
`liquidatorArabic`	string	Optional	Description: Name of the appointed liquidator in Arabic script. Example: "مكتب الملكي لتدقيق الحسابات"
`liquidatorTelephone`	string	Optional	Description: Contact telephone number for the liquidator. Example: "92328222"

Complete Response Examples

Example 1: Liquidation Start Announcement

This type of announcement indicates a company has commenced liquidation proceedings. It includes liquidator contact information for creditors to file claims.

{
  "id": "kl89IBtLINOg4u7QOakF",
  "announcementText": "إعلان عن بدء أعمال التصفية لشركة بوزقندة للتجارة ش.م.م يعلن مكتب الملكي لتدقيق الحسابات أنه يقوم بتصفية شركة بوزقندة للتجارة ش.م.م, والمسجلة لدى أمانة السجل التجاري بالرقم ١٣١١٠٠٣، وللمصفي وحده حق تمثيل الشركة في التصفية أمام الغير, وعلى الجميع مراجعة المصفي في كافة الأمور التي تتعلق بأعمال الشركة على العنوان الآتي: ص.ب: ١٠٩٨ ر.ب: ٢١١ هاتف رقم: ٩٢٣٢٨٢٢٢ كما يدعو المصفي بموجب هذا الإعلان دائني الشركة للتقدم بادعاءاتهم ضد الشركة مدعمة بالمستندات الثبوتية على العنوان المذكور أعلاه, خلال ستة أشهر من تاريخ نشر هذا الإعلان، وعلى كل من عليه حقوق للشركة أن يؤديها للمصفي على العنوان المشار إليه. المصفي",
  "arabicName": "شركة بوزقندة للتجارة",
  "companyCr": "1311003",
  "englishName": "BOUZGANDA TRADING",
  "type": "Liquidation Start",
  "sequence": 13538,
  "publication": "Official Gazette 1511",
  "publicationDate": "2023-12-17T00:00:00.000Z",
  "liquidatorArabic": "مكتب الملكي لتدقيق الحسابات",
  "liquidatorEnglish": "Royal Auditing Office",
  "liquidatorTelephone": "92328222"
}

Example 2: Liquidation End Announcement

This type of announcement indicates the liquidation process has been completed and the company has been officially dissolved.

{
  "id": "aG0vY7nuuF584vHcFD0g",
  "announcementText": "إعلان عن انتهاء أعمال التصفية لشركة النوفل للمشاريع الرائدة - توصية يعلن راشد بن ناصر بن سيف النوفلي بصفته المصفي لشركة النوفل للمشاريع الرائدة - توصية، والمسجلة لدى أمانة السجل التجاري بالرقم ١٠٧٥٠٤٩، عن انتهاء أعمال التصفية وزوال الكيان القانوني للشركة. المصفي",
  "arabicName": "شركة النوفل للمشاريع الرائدة",
  "companyCr": "1075049",
  "englishName": "(AL NAWFAL FOR LEADING PROJECTS COMPANY)",
  "type": "Liquidation End",
  "sequence": 13568,
  "publication": "Official Gazette 1511",
  "publicationDate": "2023-12-17T00:00:00.000Z",
  "liquidatorArabic": "راشد بن ناصر بن سيف النوفلي",
  "liquidatorEnglish": "Rashid bin Nasser bin Saif Al Nawfali"
}

Example 3: Dissolution and Merger Announcement

This type of announcement relates to company dissolutions, mergers, or acquisitions. These announcements follow the same structure as other announcement types.

{
  "id": "gNRpNmeqvGiElm74nw6o",
  "announcementText": "تعلن شركة الطريق الصحيح للخدمات المقيدة تحت رقم (١٤٥٨٩٣٢) بالمديرية العامة للتجارة والصناعة وترويج الاستثمار بمحافظة مسقط أنها بصدد الحل واندماج عن طريق الضم إلى شركة الطريق الصحيح للحلول المسجلة بالقيد تحت رقم (١٤٤٠٠٢٨) وذلك بموجب قرار الشركاء المؤرخ في تاريخ ٢٠٢٥/١٠/١٢م والاتفاق الجاري بين الشركاء، وكل من له اعتراض على هذا الاندماج عليه أن يتقدم باعتراضه مشفوعاً بالمستندات المؤيدة لذلك على العنوان التالي: ص.ب: ١٣٨٥ الرمز البريدي: ١١٢ هاتف: ٩٩٠٤٤٠٨٠ كما يدعو المدمج بموجب هذا الإعلان دائني الشركة بادعاءاتهم ضد الشركة مدعمة بالمستندات الثبوتية على العنوان المذكور أعلاه، خلال شهر من تاريخ نشر هذا الإعلان.",
  "arabicName": "شركة الطريق الصحيح للخدمات",
  "companyCr": "1458932",
  "englishName": "RIGHT WAY SERVICES",
  "type": "Dissolution and Merger",
  "sequence": 13426,
  "publication": "Al-Roya",
  "publicationDate": "2025-12-08T00:00:00.000Z"
}

Example 4: Complete API Response

Request:

curl -H "X-API-Key: your-api-key" \
  "https://api.decree.om/announcements/recent?limit=3"

Response:

{
  "success": true,
  "results": [
    {
      "id": "aG0vY7nuuF584vHcFD0g",
      "announcementText": "إعلان عن انتهاء أعمال التصفية لشركة النوفل للمشاريع الرائدة - توصية يعلن راشد بن ناصر بن سيف النوفلي بصفته المصفي لشركة النوفل للمشاريع الرائدة - توصية، والمسجلة لدى أمانة السجل التجاري بالرقم ١٠٧٥٠٤٩، عن انتهاء أعمال التصفية وزوال الكيان القانوني للشركة. المصفي",
      "arabicName": "شركة النوفل للمشاريع الرائدة",
      "companyCr": "1075049",
      "englishName": "(AL NAWFAL FOR LEADING PROJECTS COMPANY)",
      "type": "Liquidation End",
      "sequence": 13568,
      "publication": "Official Gazette 1511",
      "publicationDate": "2023-12-17T00:00:00.000Z",
      "liquidatorArabic": "راشد بن ناصر بن سيف النوفلي",
      "liquidatorEnglish": "Rashid bin Nasser bin Saif Al Nawfali"
    },
    {
      "id": "hL0Vj8gMUXeIa87qD7p6",
      "announcementText": "إعلان عن انتهاء أعمال التصفية لشركة مشاريع قرطبة الوطنية - تضامنية يعلن راشد بن ناصر بن سيف النوفلي بصفته المصفي لشركة مشاريع قرطبة الوطنية - تضامنية، والمسجلة لدى أمانة السجل التجاري بالرقم ١٧٢٣٩٥٢، عن انتهاء أعمال التصفية وزوال الكيان القانوني للشركة. المصفي",
      "arabicName": "شركة مشاريع قرطبة الوطنية",
      "companyCr": "1723952",
      "englishName": "(NATIONAL CORDOBA PROJECTS COMPANY)",
      "type": "Liquidation End",
      "sequence": 13567,
      "publication": "Official Gazette 1511",
      "publicationDate": "2023-12-17T00:00:00.000Z",
      "liquidatorArabic": "راشد بن ناصر بن سيف النوفلي",
      "liquidatorEnglish": "Rashid bin Nasser bin Saif Al Nawfali"
    },
    {
      "id": "kl89IBtLINOg4u7QOakF",
      "announcementText": "إعلان عن بدء أعمال التصفية لشركة بوزقندة للتجارة ش.م.م يعلن مكتب الملكي لتدقيق الحسابات أنه يقوم بتصفية شركة بوزقندة للتجارة ش.م.م, والمسجلة لدى أمانة السجل التجاري بالرقم ١٣١١٠٠٣، وللمصفي وحده حق تمثيل الشركة في التصفية أمام الغير, وعلى الجميع مراجعة المصفي في كافة الأمور التي تتعلق بأعمال الشركة على العنوان الآتي: ص.ب: ١٠٩٨ ر.ب: ٢١١ هاتف رقم: ٩٢٣٢٨٢٢٢ كما يدعو المصفي بموجب هذا الإعلان دائني الشركة للتقدم بادعاءاتهم ضد الشركة مدعمة بالمستندات الثبوتية على العنوان المذكور أعلاه, خلال ستة أشهر من تاريخ نشر هذا الإعلان، وعلى كل من عليه حقوق للشركة أن يؤديها للمصفي على العنوان المشار إليه. المصفي",
      "arabicName": "شركة بوزقندة للتجارة",
      "companyCr": "1311003",
      "englishName": "BOUZGANDA TRADING",
      "type": "Liquidation Start",
      "sequence": 13538,
      "publication": "Official Gazette 1511",
      "publicationDate": "2023-12-17T00:00:00.000Z",
      "liquidatorArabic": "مكتب الملكي لتدقيق الحسابات",
      "liquidatorEnglish": "Royal Auditing Office",
      "liquidatorTelephone": "92328222"
    }
  ],
  "count": 3,
  "limit": 3,
  "types": ["Liquidation Start", "Liquidation End", "Dissolution and Merger"]
}

Note: The types field in the response shows which announcement types were used to filter the results. By default, only "Liquidation Start", "Liquidation End", and "Dissolution and Merger" announcements are returned.

Field Value Types

Understanding the different types of values you'll encounter in key fields:

Announcement Types

The API returns announcements with the following type values by default:

Type	Description	Key Fields
`"Liquidation Start"`	Notice of commencement of liquidation proceedings. Creditors have 6 months from the publication date to submit claims.	`liquidatorEnglish`, `liquidatorArabic`, `liquidatorTelephone`
`"Liquidation End"`	Notice that liquidation proceedings have been completed and the company has been officially dissolved.	Standard fields only
`"Dissolution and Merger"`	Notice of company dissolution, merger, or acquisition with another entity.	Standard fields only

Liquidator Fields

For "Liquidation Start" announcements, the following fields may be present:

liquidatorEnglish - Name of the appointed liquidator in English
liquidatorArabic - Name of the appointed liquidator in Arabic
liquidatorTelephone - Contact telephone number for the liquidator

Publication Sources

The publication field indicates where the announcement was published:

"Official Gazette XXXX" - Government of Oman official gazette publications (where XXXX is the issue number)
Other official sources as applicable

Date Formats

All dates use ISO 8601 format with UTC timezone:

Format: YYYY-MM-DDTHH:mm:ss.sssZ
Example: "2025-12-10T16:29:13.000Z"
Timezone: Always UTC (indicated by the Z suffix)
Parsing: Compatible with JavaScript Date(), Python datetime.fromisoformat(), and most modern date libraries

Creditor Claim Deadline

Important: Under Omani law, creditors must submit claims within 6 months from the publicationDate of a "Liquidation Start" announcement. After this deadline, the right to claim is forfeited. Use the publicationDate field to calculate claim deadlines in your applications.

Error Responses

401 Unauthorized

Missing or invalid API key

{
  "success": false,
  "error": "Invalid or missing API key. Please provide a valid API key in the X-API-Key header."
}

429 Too Many Requests

Rate limit exceeded

{
  "success": false,
  "error": "Rate limit exceeded",
  "limit": 1000,
  "resetAt": "2025-12-10T15:30:00.000Z"
}

400 Bad Request

Missing required parameters

{
  "success": false,
  "error": "companyCr parameter is required"
}

500 Internal Server Error

Server error

{
  "success": false,
  "error": "Error message"
}

Best Practices

Recommended Integration Approach

To maintain data privacy and minimise external data exposure, we recommend the following approach:

Use the /announcements/recent endpoint to periodically retrieve the latest announcements
Cross-reference announcements against your internal database by matching the companyCr field with your organisation's records
Avoid using the /announcements/by-cr endpoint unless necessary, as this requires transmitting Commercial Registration numbers externally
Store matched results internally to build a historical record without repeated API calls

This approach ensures that your organisation's supplier or client CR numbers remain within your internal systems, while still enabling you to identify relevant liquidation and dissolution announcements.

General Recommendations

Cache responses when appropriate to reduce API calls
Monitor rate limit headers to avoid hitting limits
Use reasonable limit values - only request what you need
Handle errors gracefully with proper retry logic
Keep your API key secure - never expose it in client-side code
Use HTTPS for all API requests