Service Notifications

Overview

Information on services updates, changes, and notifications for users and system administrators of the Markaaz API's.

Please be advised this page contains informative updates and documentation only.

If Markaaz experiences a critical system event, such as a services interruption, please be advised that we will communicate system event notifications proactively to the key contacts your organization has specified to receive them.

Markaaz Id Object Enhancement - 2/1/2025

Enhancement Overview

Our "markaazId" field object is a unique identifier created by Markaaz for authenticated and verified businesses in our global business directory.

When you submit requests to our API services for Advanced Match or Search, a 200 response from our APIs will include the "markaazId" in the "searchResults" array for the highest-ranked matched business we located based on the input data in your request. If you are utilizing any of our customization options for expanded records search or return non-matched records, the "markaazId" will also be included for those lower-ranking business matches as well.

This "markaazId" is unique for every business and is the key input token to pull insights on that business through our additional Business Verification APIs for added data enrichment. This includes services like Firmographic Data, Compliance Details, Business Health, etc.

Markaaz has upgraded our Business Directory to a new database architecture and data management system as part of our continual efforts to invest in our technology. The primary benefit of this to customers is improved efficiency in sorting and returning data in our products. To help our customers capitalize on these benefits, we need to migrate all customers over to this new environment.

Our migration is planned, with no planned impact to customers, and not requiring customers to take any actions. Our Operations team has been reaching out to customers advising of our plans in advance of the planned migration. However, with this upgrade, it does present a change in this key "markaazId" field we are asking customers to review their technical operations to ensure it does not cause any issues to their technology operations or infrastructure.

Changes to Markaaz Id Field

The “markaazId” is provided in the Business Match service response and is the Markaaz unique identifier for that business in our business directory. It is utilized to identify a business in the Markaaz system and is a key field that allows successful searching of our Business Verification APIs for additional insights like firmographic, diversity, and compliance.
With this upgrade, we will be updating the “markaazId” field from a 15-digit alphanumeric format to a 16-digit numeric format.

Key Points to Note:

• New format: 16-digit numeric
• Old format: 15-digit alphanumeric

Action Required:
We kindly request that you review your applications that interact with our API to ensure they can handle the new “markaazId” format.

Please pay special attention to:

• Data validation: confirming the changed field string regex does not cause any schema validation failures.
• Storage mechanisms: confirming your database is ready to receive the “markaazId” as a 16-digit numeric string value.
• Display formatting: confirming your external applications and user interfaces can display the “markaazId” in the new format.

Important Information:

• Search Results: All search results will return the new 16-digit numeric "markaazId" following the deployment of this change.
• Legacy Support: We will continue to support the legacy 15-digit alphanumeric "markaazId" for direct company lookups to ensure a smooth transition as customers transition off of it. Markaaz will return the new 16-digit numeric “markaazId” in response to legacy search requests and recommends replacing the legacy 15-digit alphanumeric value if subsequent searches will need to be performed.