GetBasicDetails
POST
https://test.api.neotek.sa/establishment-information/v1/get-basic-detailsSandbox URL · in Production call https://api.neotek.sa
The establishment's identity, registration status and economic activity classification.
Body — Data is required, and must carry one of the two identifiers:
| Parameter | Required | Description |
|---|---|---|
Data.CRNumber | Conditional | the commercial registration number. Required if SevenHundredNumber is absent |
Data.SevenHundredNumber | Conditional | the 700-series unified number. Required if CRNumber is absent |
Headers:
| Parameter | Required | Description |
|---|---|---|
authorization | Required | Bearer <ACCESS_TOKEN>, with scope establishment_information |
content-type | Required | application/json. Absent from the specification's header table, but omitting it returns 415 |
accept | Optional | returns 406 if present and mismatched |
x-request-id | Optional | an RFC 4122 UUID you generate; recommended for tracing |
accept-language | Optional | backend-dependent; the likely control over which language the text fields come back in |
sub-client | Optional | identifies the downstream consumer when one client fronts several |
cURL
curl -X POST 'https://test.api.neotek.sa/establishment-information/v1/get-basic-details' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ --header 'content-type: application/json' \ --data '{ "Data": { "SevenHundredNumber": "7001234568" } }'Response
JSON
{ "Data": { "Name": "شركة الأمثلة للمقاولات", "Type": "شركة", "Size": "عملاقة", "Status": "قائمة", "EstablishmentEconomicActivity": "مقاولات التشييد والبناء والنظافة", "EstablishmentEconomicActivityCode": 450, "ISICActivity": "التنظيف العام للمباني", "ISICActivitycode": 537, "CertificateStartDate": "2015-01-01 00:00:00.000", "CertificateEndDate": "2026-12-31 00:00:00.000", "LegalRegistration": "ذات مسؤولية محدودة", "CRNumber": 1010001234, "SevenHundredNumber": 7001234567, "CRStatus": "Active", "LaborOfficeId": 6, "ClosingDate": "2027-01-01" }}Errors
| Code | Status | Cause and Action |
|---|---|---|
400 | Bad Request | Missing required field, or a value that fails validation — check Code and Path in the body |
401 | Unauthorized | Bearer token missing, expired, or invalid |
403 | Forbidden | Token doesn't carry the establishment_information scope |
404 | Not Found | No resource matches the identifier provided |
405 | Method Not Allowed | HTTP verb not supported on that path |
406 | Not Acceptable | Accept header doesn't match a supported representation |
415 | Unsupported Media Type | Content-Type missing or wrong |
429 | Too Many Requests | Rate limit exceeded |
500 | Internal Server Error | Server error — retry with backoff, quote your x-request-id |