GET /api/v1/kyb/spl/national-address/{crNumber} — Get National Address
Retrieves the Saudi Post (SPL) national address information for a business based on its commercial registration number.
Authentication
SadqAuthorize
Request Headers
- Authorization (required)
- Bearer {token}
Path Parameters
- crNumber (string, required)
- The commercial registration number
Responses
HTTP 200 — National address retrieved
{
"data": [
{
"title": "Test Company XYZ - Dummy Record",
"address": "0000 Test Street - Fake District",
"address2": "TESTCITY 00000 - 0000",
"latitude": "0.000000",
"longitude": "0.000000",
"buildingNumber": "0000",
"street": "Test Street",
"district": "Fake District",
"districtId": "TEST-DIST-001",
"city": "TESTCITY",
"cityId": "000",
"postCode": "00000",
"additionalNumber": "0000",
"regionName": "Test Region",
"regionId": "000",
"isPrimaryAddress": "false",
"unitNumber": "0",
"restriction": "TEST_ONLY",
"pkAddressId": "TEST-0000000000",
"status": "Inactive"
}
],
"errorCode": 0,
"message": "",
"returnUrl": "/dashboard",
"stateValidationErrors": null,
"signature": ""
}HTTP 200 — No data returned
{
"data": null,
"errorCode": 100,
"message": "No data returned from SPL National Address endpoint",
"returnUrl": "/dashboard",
"stateValidationErrors": null,
"signature": ""
}