National Address

National Address data provides verified location details for a company, enabling validation of its registered operating address and supporting address-based risk, compliance, and onboarding workflows.

The table below outlines all data fields returned as part of this dataset.

Retrieving a company's National Address

To retrieve National Address information, call the Business Verification API with type = address, providing the company’s Unified National Number (UNN).

This dataset returns the officially registered National Address records associated with the business.

Data Coverage

Category	Field Path	Description
Address Overview	title	Registered business name associated with the address
Address Overview	status	Address status (e.g. Active)
Address Identification	pkAddressId	Unique identifier for the address record
Address Identification	isPrimaryAddress	Indicates whether this is the primary registered address
Location – Full Address	address	Primary address line
Location – Full Address	address2	Secondary formatted address line
Location – Building Details	buildingNumber	Building number
Location – Building Details	unitNumber	Unit number (if applicable)
Location – Building Details	additionalNumber	Additional address number
Location – Street Details	street	Street name
Location – District	district	District name
Location – District	districtId	District ID
Location – City	city	City name
Location – City	cityId	City ID
Location – Region	regionName	Region name
Location – Region	regionId	Region ID
Location – Postal Information	postCode	Postal code
Geolocation	latitude	Latitude coordinate
Geolocation	longitude	Longitude coordinate
Address Metadata	restriction	Address restriction details (if applicable)

Examples

Request

{
  "type": "ADDRESS",
  "identifications": [
    {
      "type": "UNIFIED_NUMBER",
      "value": "7001272184"
    }
  ],
  "language": "en"
}

Response

{
    "status": "OK",
    "results_id": "eb07c13d-e321-4a22-b397-7ac0593869d3",
    "message": "Data successfully retrieved",
    "meta": null,
    "timestamp": "2026-02-13T12:16:39.809130793Z",
    "status_detail": null,
    "verifications": {
        "status": null,
        "commercial_registry": null,
        "company_name": null,
        "name_language": null,
        "commercial_registration_capital": null,
        "days_since_company_established": null,
        "main_commercial_registry": null,
        "issue_date": null,
        "in_liquidation_process": null,
        "has_e_commerce": null,
        "headquarters": null,
        "license": null,
        "partners": null,
        "entity_type": null,
        "confirmation_date": null,
        "reactivation_date": null,
        "suspension_date": null,
        "deletion_date": null,
        "contact_info": null,
        "e_commerce": null,
        "capital_information": null,
        "fiscal_year": null,
        "parties": null,
        "management": null,
        "liquidators": null,
        "activities": null,
        "contract_copy_number": null,
        "contract_date": null,
        "notification_channel": null,
        "partner_decision": null,
        "additional_decision_text": null,
        "set_aside_details": null,
        "articles": null,
        "additional_articles": null,
        "addresses": [
            {
                "title": "Lean Technologies Saudi Arabia Information Systems Technology One Person Company",
                "address": "3403 Al Hawi - Hiteen Dist.",
                "address2": "RIYADH 13516 - 7465",
                "latitude": "24.77540105",
                "longitude": "46.60983378",
                "building_number": "3403",
                "street": "Al Hawi",
                "district": "Hiteen Dist.",
                "district_id": "",
                "city": "RIYADH",
                "city_id": "3",
                "post_code": "13516",
                "additional_number": "7465",
                "region_name": "Al Riyadh",
                "region_id": "1",
                "is_primary_address": "true",
                "unit_number": "1",
                "restriction": "",
                "pk_address_id": "1351634037465",
                "status": "Active"
            }
        ]
    }
}

Testing the API

To test the Business Verification API, set the type to type to 'ADDRESS' and use the UNN 7001272184.