Establishment Details
Overview
A lookup API over Saudi establishment records — the MHRSD/Nitaqat view of a company. You pass one identifier for a business and get back its registration status, economic activity classification, and workforce composition.
Prerequisites
- Authentication: Obtain an access token using the Client Credentials flow (see Getting Started → Authentication). Use scope
establishment_informationwhen generating the token. - Subscription: Subscribe to Establishment Details in your chosen environment.
This is a Value Added Product, so it sits outside the Open Banking consent model — no Accounts Link, no customer consent flow, just OAuth2 client credentials with a single scope.
Endpoints
Both take the same body and headers. They differ in how much of the record comes back.
| Endpoint | Returns |
|---|---|
| GetBasicDetails | Identity, registration status and economic activity |
| GetAdvancedDetails | The same, plus Saudization figures and workforce counts |
| GetPremiumDetails | The same again, plus the Nitaqat band, work permits, violations and WPS status |
Ready to build with Establishment Details?
Create a sandbox app, grab your credentials, and make your first call in minutes.