Markaaz

For AI agents: visit https://help.socure.com/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI.

Markaaz Skip link to Markaaz

Markaaz is the world’s most comprehensive source of verified business identity data, enabling businesses to prospect, onboard, verify, decision, and monitor clients globally. Through the Markaaz Global Data Directory, they create Golden Records that unify fragmented information into a single, trusted source. This delivers a holistic, authoritative view of a business built on global data, advanced analytics, and rigorous stewardship.

Products offered via RiskOS™ Skip link to Products offered via RiskOS™

Note that Socure offers Advanced Match, Compliance Details, and Firmographic Data bundled together as the Markaaz Identity Bundle.

Product Name Description RiskOS™ Use Cases
Advanced Match/Business Verification Business Verification data used to verify the legitimacy and existence of a business. Global KYB, Business onboarding, Regulatory compliance
Compliance Information used to assess regulatory risk and ensure legal compliance. Includes politically exposed persons (PEP) status, sanctions screening, beneficial ownership, business registration status, licensing information, and more. KYB onboarding, regulatory compliance, fraud prevention
Firmographic Data Firmographic data such as Registered Address, registration status, known identifiers such as Registration Number, Tax ID, hierarchy, and more. Global KYB, Business onboarding, Regulatory compliance
Business Hierarchy Records that contain parent–child business relationships. Hierarchy data identifies whether an entity is a headquarters, branch, subsidiary, or part of a larger corporate structure. Risk exposure analysis, compliance, complex entity verification
Business Health Indicators that reflect the operational stability or financial condition of a business. May include status flags, activity indicators, risk signals, operational tenure, and other metrics used to gauge overall business viability. Risk assessment, underwriting
P2B (Person-to-business linkage) Data connecting individuals to the businesses they own or manage. P2B includes beneficial owners, officers, directors, shareholders, and governance relationships that support due diligence and risk assessment. Identity verification, fraud detection, UBO investigation, risk assessment
Financial Data Surfaces litigation history, judgments, and bankruptcy filings for a business, including jurisdiction, status, and involved parties. Underwriting, KYB, Business onboarding, Compliance

Example API responses Skip link to Example API responses

Advanced Match/Business Verification

JSON

{
"markaaz": {
  "traceId": "string",
  "message": "string",
  "matchResults": [\
    {\
      "markaazId": "string",\
      "markaazMatchConfidenceScore": 0,\
      "matchConfidenceThreshold": 0,\
      "epInternalId": "string",\
      "bizInfo": {\
        "dba": "string",\
        "legalName": "string",\
        "taxId": "string",\
        "nationalId": "string",\
        "website": "string",\
        "phoneNumber": "string",\
        "addresses": [\
          {\
            "type": "string",\
            "line1": "string",\
            "line2": "string",\
            "locality": "string",\
            "region": "string",\
            "postalCode": "string",\
            "country": "string",\
            "latitude": "string",\
            "longitude": "string",\
            "geoprecision": "string",\
            "businessIndicator": "string",\
            "residentialIndicator": "string",\
            "sohoIndicator": "string"\
          }\
        ]\
      },\
      "primaryContact": {\
        "fullName": "string",\
        "titleCode": "string",\
        "title": "string",\
        "firstName": "string",\
        "lastName": "string",\
        "email": "string"\
      },\
      "metaData": {\
        "dba": {\
          "grade": "string"\
        },\
        "companyLegalName": {\
          "grade": "string"\
        },\
        "address": {\
          "grade": "string"\
        },\
        "locality": {\
          "grade": "string"\
        },\
        "region": {\
          "grade": "string"\
        },\
        "postalCode": {\
          "grade": "string"\
        },\
        "nationalId": {\
          "grade": "string"\
        },\
        "taxId": {\
          "grade": "string"\
        },\
        "phoneNumber": {\
          "grade": "string"\
        },\
        "website": {\
          "grade": "string"\
        },\
        "contactName": {\
          "grade": "string"\
        }\
      }\
    }\
  ]
}
}

Compliance

JSON

{
"markaaz": {
  "traceId": "string",
  "markaazId": "string",
  "epInternalId": "string",
  "bizInfo": {
    "dba": "string",
    "legalName": "string",
    "taxId": "string",
    "nationalId": "string",
    "addresses": [\
      {\
        "type": "string",\
        "line1": "string",\
        "line2": "string",\
        "locality": "string",\
        "region": "string",\
        "postalCode": "string",\
        "country": "string",\
        "latitude": "string",\
        "longitude": "string",\
        "geoprecision": "string",\
        "businessIndicator": "string",\
        "residentialIndicator": "string",\
        "sohoIndicator": "string"\
      }\
    ]
  },
  "complianceSummary": {
    "activeSanctions": 0,
    "activeInsolvency": 0,
    "activePoliticallyExposedPersons": 0,
    "activeAdverseMedia": 0,
    "activeLawEnforcement": 0
  },
  "complianceDetails": {
    "evidences": [\
      {\
        "originalUrl": "string",\
        "credibility": "string",\
        "language": "string",\
        "evidenceId": "string",\
        "captureDateIso": "string",\
        "publicationDateIso": "string",\
        "isCopyrighted": "string",\
        "assetUrl": "string",\
        "title": "string",\
        "summary": "string",\
        "keywords": "string",\
        "datasets": [\
          "string"\
        ]\
      }\
    ],
    "pep": [\
      {\
        "qrCode": "string",\
        "firstName": "string",\
        "middleName": "string",\
        "lastName": "string",\
        "relationship": "string",\
        "ownershipPercentage": "string",\
        "resourceUri": "string",\
        "resourceId": "string",\
        "datasets": [\
          "string"\
        ]\
      }\
    ],
    "adverseMedia": [\
      {\
        "category": "string",\
        "subcategory": "string",\
        "events": [\
          {\
            "type": "string",\
            "dateIso": "string",\
            "evidenceIds": [\
              "string"\
            ]\
          }\
        ]\
      }\
    ],
    "lawEnforcement": [\
      {\
        "category": "string",\
        "subcategory": "string",\
        "events": [\
          {\
            "type": "string",\
            "currencyCode": "string",\
            "amount": 0,\
            "period": {\
              "days": 0,\
              "years": 0,\
              "months": 0\
            },\
            "dateIso": "string",\
            "evidenceIds": [\
              "string"\
            ]\
          }\
        ]\
      }\
    ],
    "insolvency": [\
      {\
        "type": "string",\
        "insolvencyIdNumber": "string",\
        "solicitor": "string",\
        "court": "string",\
        "petitioner": "string",\
        "debt": "string",\
        "accountantInBankruptcyCaseNumber": "string",\
        "insolvencyStartDateIso": "string",\
        "insolvencyEndDateIso": "string",\
        "hearingDateIso": "string",\
        "presentedDateOfPetitionIso": "string",\
        "gazetteIssueDateIso": "string",\
        "awardDateIso": "string",\
        "firstOrderDateIso": "string",\
        "evidenceIds": [\
          "string"\
        ]\
      }\
    ],
    "sanctions": {
      "current": [\
        {\
          "sanctionId": "string",\
          "measures": [\
            "string"\
          ],\
          "regime": {\
            "body": "string",\
            "name": "string",\
            "origin": "string",\
            "types": [\
              "string"\
            ]\
          },\
          "events": [\
            {\
              "type": "string",\
              "dateIso": "string",\
              "evidenceIds": [\
                "string"\
              ]\
            }\
          ]\
        }\
      ],
      "former": [\
        {\
          "sanctionId": "string",\
          "measures": [\
            "string"\
          ],\
          "regime": {\
            "body": "string",\
            "name": "string",\
            "origin": "string",\
            "types": [\
              "string"\
            ]\
          },\
          "events": [\
            {\
              "type": "string",\
              "dateIso": "string",\
              "evidenceIds": [\
                "string"\
              ]\
            }\
          ]\
        }\
      ]
    }
  }
}
}

Firmographic Data

JSON

Business Hierarchy

JSON

Business Health

JSON

P2B (Person-to-business linkage)

JSON

Financial Data

JSON

Data dictionary Skip link to Data dictionary

Advanced Match/Business Verification

Field Type Description
markaaz Object Root response object.
markaaz.traceId String (UUID) Trace ID for the request.
markaaz.message String Response message.
markaaz.matchResults Array List of candidate business matches.
markaaz.matchResults[].markaazId String Markaaz ID of the matched business.
markaaz.matchResults[].markaazMatchConfidenceScore Number Match confidence on a 1–10 scale. 10 indicates a very high-confidence match on all data elements present; 1 indicates a match on Name only.
markaaz.matchResults[].matchConfidenceThreshold Number The configured Match Confidence Threshold used for this match. Recommended setting is 8.3 for a high-confidence match.
markaaz.matchResults[].epInternalId String Partner's internal business identifier, echoed back. Max 500 chars. Not stored by Matching.
markaaz.matchResults[].bizInfo Object Business info for the matched candidate.
markaaz.matchResults[].bizInfo.dba String Doing Business As name.
markaaz.matchResults[].bizInfo.legalName String Business legal name.
markaaz.matchResults[].bizInfo.taxId String Business Tax ID.
markaaz.matchResults[].bizInfo.nationalId String National ID.
markaaz.matchResults[].bizInfo.website String Business website.
markaaz.matchResults[].bizInfo.phoneNumber String Business phone number.
markaaz.matchResults[].bizInfo.addresses Array
 Addresses on file for the matched business.
markaaz.matchResults[].bizInfo.addresses[].type String Address type (e.g., Primary, Registered, Secondary).
markaaz.matchResults[].bizInfo.addresses[].line1 String First line of the address.
markaaz.matchResults[].bizInfo.addresses[].line2 String Second line of the address.
markaaz.matchResults[].bizInfo.addresses[].locality String City in which the business is based.
markaaz.matchResults[].bizInfo.addresses[].region String State/region in which the business is based.
markaaz.matchResults[].bizInfo.addresses[].postalCode String Postal code of the business address.
markaaz.matchResults[].bizInfo.addresses[].country String Country where the business is based.
markaaz.matchResults[].bizInfo.addresses[].latitude String Latitude of the business location.
markaaz.matchResults[].bizInfo.addresses[].longitude String Longitude of the business location.
markaaz.matchResults[].bizInfo.addresses[].geoprecision String Precision level of the geocoded location.
markaaz.matchResults[].bizInfo.addresses[].businessIndicator String Indicator of whether the address is a business location.
markaaz.matchResults[].bizInfo.addresses[].residentialIndicator String Indicator of whether the address is residential.
markaaz.matchResults[].bizInfo.addresses[].sohoIndicator String Small office/home office indicator.
markaaz.matchResults[].primaryContact Object Primary contact on file for the matched business.
markaaz.matchResults[].primaryContact.fullName String Primary contact full name.
markaaz.matchResults[].primaryContact.titleCode String Primary contact title code.
markaaz.matchResults[].primaryContact.title String Primary contact title.
markaaz.matchResults[].primaryContact.firstName String Primary contact first name.
markaaz.matchResults[].primaryContact.lastName String Primary contact last name.
markaaz.matchResults[].primaryContact.email String Primary contact email address.
markaaz.matchResults[].metaData Object Present when showGrades is true. Per-field match grade for each submitted input.
markaaz.matchResults[].metaData.dba.grade String (enum) Match grade for DBA. A = exact match; B = similar match with ≥1 common token; C = partial match with 0–1 common token; F = no match, or input provided but no value returned; Z = input not provided.
markaaz.matchResults[].metaData.companyLegalName.grade String (enum) Match grade for Company Legal Name (see grade scale above).
markaaz.matchResults[].metaData.address.grade String (enum) Match grade for Address (see grade scale above).
markaaz.matchResults[].metaData.locality.grade String (enum) Match grade for Locality (see grade scale above).
markaaz.matchResults[].metaData.region.grade String (enum) Match grade for Region (see grade scale above).
markaaz.matchResults[].metaData.postalCode.grade String (enum) Match grade for Postal Code (see grade scale above).
markaaz.matchResults[].metaData.nationalId.grade String (enum) Match grade for National ID (see grade scale above).
markaaz.matchResults[].metaData.taxId.grade String (enum) Match grade for Tax ID (see grade scale above).
markaaz.matchResults[].metaData.phoneNumber.grade String (enum) Match grade for Phone Number (see grade scale above).
markaaz.matchResults[].metaData.website.grade String (enum) Match grade for Website (see grade scale above).
markaaz.matchResults[].metaData.contactName.grade String (enum) Match grade for Contact Name (see grade scale above).

Compliance

Field Type Description
markaaz Object Root response object.
markaaz.traceId String Trace ID for the request.
markaaz.markaazId String Markaaz ID of the business.
markaaz.epInternalId String Partner's internal business identifier, echoed back. Not stored by Matching. Max 250 chars.
markaaz.bizInfo Object Business info for the business.
markaaz.bizInfo.dba String Doing Business As name. Max 1000 chars.
markaaz.bizInfo.legalName String Business legal name. Max 1000 chars.
markaaz.bizInfo.taxId String Business Tax ID. Max 100 chars.
markaaz.bizInfo.nationalId String National ID. Max 500 chars.
markaaz.bizInfo.addresses Array
 Addresses on file for the business.
markaaz.bizInfo.addresses[].type String Address type (e.g., Primary, Registered, Secondary).
markaaz.bizInfo.addresses[].line1 String First line of the address.
markaaz.bizInfo.addresses[].line2 String Second line of the address.
markaaz.bizInfo.addresses[].locality String City in which the business is based.
markaaz.bizInfo.addresses[].region String State/region in which the business is based.
markaaz.bizInfo.addresses[].postalCode String Postal code of the business address.
markaaz.bizInfo.addresses[].country String Country where the business is based.
markaaz.bizInfo.addresses[].latitude String Latitude of the business location.
markaaz.bizInfo.addresses[].longitude String Longitude of the business location.
markaaz.bizInfo.addresses[].geoprecision String Precision level of the geocoded location.
markaaz.bizInfo.addresses[].businessIndicator String Indicator of whether the address is a business location.
markaaz.bizInfo.addresses[].residentialIndicator String Indicator of whether the address is residential.
markaaz.bizInfo.addresses[].sohoIndicator String Small office/home office indicator.
markaaz.complianceSummary Object Roll-up counts of compliance hits by category.
markaaz.complianceSummary.activeSanctions Integer Count of active sanctions hits.
markaaz.complianceSummary.activeInsolvency Integer Count of active insolvency hits.
markaaz.complianceSummary.activePoliticallyExposedPersons Integer Count of active PEP (Politically Exposed Persons) hits.
markaaz.complianceSummary.activeAdverseMedia Integer Count of active adverse media hits.
markaaz.complianceSummary.activeLawEnforcement Integer Count of active law enforcement hits.
markaaz.complianceDetails Object Detailed compliance evidence and hit records.
markaaz.complianceDetails.evidences Array Source evidence backing the compliance hits below.
markaaz.complianceDetails.evidences[].originalUrl String Original source URL for the evidence.
markaaz.complianceDetails.evidences[].credibility String Credibility rating of the source.
markaaz.complianceDetails.evidences[].language String Language of the source content.
markaaz.complianceDetails.evidences[].evidenceId String Unique identifier for the evidence record.
markaaz.complianceDetails.evidences[].captureDateIso String Date the evidence was captured (ISO format).
markaaz.complianceDetails.evidences[].publicationDateIso String Date the source content was published (ISO format).
markaaz.complianceDetails.evidences[].isCopyrighted String Whether the source content is copyrighted.
markaaz.complianceDetails.evidences[].assetUrl String URL to the archived asset for the evidence.
markaaz.complianceDetails.evidences[].title String Title of the evidence/source content.
markaaz.complianceDetails.evidences[].summary String Summary of the evidence/source content.
markaaz.complianceDetails.evidences[].keywords String Keywords associated with the evidence.
markaaz.complianceDetails.evidences[].datasets Array Dataset(s) the evidence was sourced from.
markaaz.complianceDetails.pep Array Politically Exposed Persons associated with the business.
markaaz.complianceDetails.pep[].qrCode String QR code/reference for the PEP record.
markaaz.complianceDetails.pep[].firstName String PEP first name.
markaaz.complianceDetails.pep[].middleName String PEP middle name.
markaaz.complianceDetails.pep[].lastName String PEP last name.
markaaz.complianceDetails.pep[].relationship String Relationship of the PEP to the business.
markaaz.complianceDetails.pep[].ownershipPercentage String Ownership percentage held by the PEP, if applicable.
markaaz.complianceDetails.pep[].resourceUri String URI to the underlying PEP resource.
markaaz.complianceDetails.pep[].resourceId String Identifier of the underlying PEP resource.
markaaz.complianceDetails.pep[].datasets Array Dataset(s) the PEP record was sourced from.
markaaz.complianceDetails.adverseMedia Array Adverse media hits associated with the business.
markaaz.complianceDetails.adverseMedia[].category String Adverse media category.
markaaz.complianceDetails.adverseMedia[].subcategory String Adverse media subcategory.
markaaz.complianceDetails.adverseMedia[].events Array Individual adverse media events.
markaaz.complianceDetails.adverseMedia[].events[].type String Event type.
markaaz.complianceDetails.adverseMedia[].events[].dateIso String Event date (ISO format).
markaaz.complianceDetails.adverseMedia[].events[].evidenceIds Array Evidence ID(s) supporting the event.
markaaz.complianceDetails.lawEnforcement Array Law enforcement hits associated with the business.
markaaz.complianceDetails.lawEnforcement[].category String Law enforcement category.
markaaz.complianceDetails.lawEnforcement[].subcategory String Law enforcement subcategory.
markaaz.complianceDetails.lawEnforcement[].events Array Individual law enforcement events.
markaaz.complianceDetails.lawEnforcement[].events[].type String Event type.
markaaz.complianceDetails.lawEnforcement[].events[].currencyCode String Currency code for any monetary amount tied to the event.
markaaz.complianceDetails.lawEnforcement[].events[].amount Integer Monetary amount tied to the event.
markaaz.complianceDetails.lawEnforcement[].events[].period Object Duration associated with the event (e.g., sentence length).
markaaz.complianceDetails.lawEnforcement[].events[].period.days Integer Number of days.
markaaz.complianceDetails.lawEnforcement[].events[].period.years Integer Number of years.
markaaz.complianceDetails.lawEnforcement[].events[].period.months Integer Number of months.
markaaz.complianceDetails.lawEnforcement[].events[].dateIso String Event date (ISO format).
markaaz.complianceDetails.lawEnforcement[].events[].evidenceIds Array Evidence ID(s) supporting the event.
markaaz.complianceDetails.insolvency Array Insolvency filings associated with the business.
markaaz.complianceDetails.insolvency[].type String Type of insolvency filing.
markaaz.complianceDetails.insolvency[].insolvencyIdNumber String Insolvency case/ID number.
markaaz.complianceDetails.insolvency[].solicitor String Solicitor associated with the filing.
markaaz.complianceDetails.insolvency[].court String Court handling the filing.
markaaz.complianceDetails.insolvency[].petitioner String Petitioner in the filing.
markaaz.complianceDetails.insolvency[].debt String Debt amount/description associated with the filing.
markaaz.complianceDetails.insolvency[].accountantInBankruptcyCaseNumber String Case number assigned by the Accountant in Bankruptcy (or equivalent body).
markaaz.complianceDetails.insolvency[].insolvencyStartDateIso String Insolvency start date (ISO format).
markaaz.complianceDetails.insolvency[].insolvencyEndDateIso String Insolvency end date (ISO format).
markaaz.complianceDetails.insolvency[].hearingDateIso String Hearing date (ISO format).
markaaz.complianceDetails.insolvency[].presentedDateOfPetitionIso String Date the petition was presented (ISO format).
markaaz.complianceDetails.insolvency[].gazetteIssueDateIso String Gazette issue date (ISO format).
markaaz.complianceDetails.insolvency[].awardDateIso String Award date (ISO format).
markaaz.complianceDetails.insolvency[].firstOrderDateIso String First order date (ISO format).
markaaz.complianceDetails.insolvency[].evidenceIds Array Evidence ID(s) supporting the insolvency record.
markaaz.complianceDetails.sanctions Object Sanctions data, split into current and former.
markaaz.complianceDetails.sanctions.current Array Currently active sanctions.
markaaz.complianceDetails.sanctions.current[].sanctionId String Unique identifier for the sanction record.
markaaz.complianceDetails.sanctions.current[].measures Array Sanction measure(s) applied.
markaaz.complianceDetails.sanctions.current[].regime Object Sanctioning regime details.
markaaz.complianceDetails.sanctions.current[].regime.body String Governing body issuing the sanction.
markaaz.complianceDetails.sanctions.current[].regime.name String Name of the sanctions regime.
markaaz.complianceDetails.sanctions.current[].regime.origin String Origin/jurisdiction of the sanctions regime.
markaaz.complianceDetails.sanctions.current[].regime.types Array Type(s) of sanctions regime.
markaaz.complianceDetails.sanctions.current[].events Array Individual sanction events.
markaaz.complianceDetails.sanctions.current[].events[].type String Event type.
markaaz.complianceDetails.sanctions.current[].events[].dateIso String Event date (ISO format).
markaaz.complianceDetails.sanctions.current[].events[].evidenceIds Array Evidence ID(s) supporting the event.
markaaz.complianceDetails.sanctions.former Array Previously active (now lifted/expired) sanctions. Same structure as sanctions.current[].

Firmographic Data

Field Type Description
markaaz Object Root response object.
markaaz.traceId String Trace ID for the request.
markaaz.markaazId String Markaaz ID of the business.
markaaz.epInternalId String Partner's internal business identifier, echoed back. Max 250 chars.
markaaz.bizInfo Object Business info for the business.
markaaz.bizInfo.dba String Doing Business As name. Max 1000 chars.
markaaz.bizInfo.legalName String Business legal name. Max 1000 chars.
markaaz.bizInfo.taxId String Business Tax ID. Max 100 chars.
markaaz.bizInfo.nationalId String National ID. Max 500 chars.
markaaz.bizInfo.addresses Array
 Addresses on file for the business.
markaaz.bizInfo.addresses[].type String Address type (e.g., Primary, Registered, Secondary).
markaaz.bizInfo.addresses[].line1 String First line of the address.
markaaz.bizInfo.addresses[].line2 String Second line of the address.
markaaz.bizInfo.addresses[].locality String City in which the business is based.
markaaz.bizInfo.addresses[].region String State/region in which the business is based.
markaaz.bizInfo.addresses[].postalCode String Postal code of the business address.
markaaz.bizInfo.addresses[].country String Country where the business is based.
markaaz.bizInfo.addresses[].latitude String Latitude of the business location.
markaaz.bizInfo.addresses[].longitude String Longitude of the business location.
markaaz.bizInfo.addresses[].geoprecision String Precision level of the geocoded location.
markaaz.bizInfo.addresses[].businessIndicator String Indicator of whether the address is a business location.
markaaz.bizInfo.addresses[].residentialIndicator String Indicator of whether the address is residential.
markaaz.bizInfo.addresses[].sohoIndicator String Small office/home office indicator.
markaaz.firmographic Object Firmographic details for the business.
markaaz.firmographic.legalStructure String Localized description of the business's legal structure; values vary by country.
markaaz.firmographic.yearEstablished Integer Year the business was established.
markaaz.firmographic.noOfEmployees Integer Number of employees.
markaaz.firmographic.noOfEmployeesLoc Integer Number of employees at this location.
markaaz.firmographic.companyStatus String Business legal status.
markaaz.firmographic.registrationDate String Registration date.
markaaz.firmographic.salesVolume Integer Sales volume.
markaaz.firmographic.salesVolumePrecision String Precision/confidence qualifier for the sales volume figure.
markaaz.firmographic.salesVolumeLoc Integer Sales volume at this location.
markaaz.firmographic.salesVolumeLocPrecision String Precision/confidence qualifier for the location sales volume figure.
markaaz.firmographic.primaryNaics String Primary NAICS code.
markaaz.firmographic.primaryNaicsDescription String Description of the primary NAICS code.
markaaz.firmographic.secondaryNaics1 String Secondary NAICS code #1.
markaaz.firmographic.secondaryNaics1Description String Description of secondary NAICS code #1.
markaaz.firmographic.secondaryNaics2 String Secondary NAICS code #2.
markaaz.firmographic.secondaryNaics2Description String Description of secondary NAICS code #2.
markaaz.firmographic.secondaryNaics3 String Secondary NAICS code #3.
markaaz.firmographic.secondaryNaics3Description String Description of secondary NAICS code #3.
markaaz.firmographic.secondaryNaics4 String Secondary NAICS code #4.
markaaz.firmographic.secondaryNaics4Description String Description of secondary NAICS code #4.
markaaz.firmographic.businessSize String Business size classification.
markaaz.firmographic.contact Object Business contact details.
markaaz.firmographic.contact.website String Business website.
markaaz.firmographic.contact.countryCallingCode String Country calling code.
markaaz.firmographic.contact.phone String Business phone number.
markaaz.firmographic.contact.fax String Business fax number.
markaaz.firmographic.officers Array Officers/principals of the business.
markaaz.firmographic.officers[].officerId String Unique identifier for the officer. Max 100 chars.
markaaz.firmographic.officers[].fullName String Officer full name. Max 100 chars.
markaaz.firmographic.officers[].title String Officer title. Max 100 chars.
markaaz.firmographic.officers[].position String Officer position. Max 100 chars.
markaaz.firmographic.officers[].currentStatus String Officer's current status (e.g., active, former). Max 100 chars.
markaaz.firmographic.primaryContact Object Primary contact for the business.
markaaz.firmographic.primaryContact.fullName String Primary contact full name.
markaaz.firmographic.primaryContact.titleCode String Primary contact title code.
markaaz.firmographic.primaryContact.title String Primary contact title.
markaaz.firmographic.primaryContact.firstName String Primary contact first name.
markaaz.firmographic.primaryContact.lastName String Primary contact last name.
markaaz.firmographic.primaryContact.email String Primary contact email address.
markaaz.firmographic.metadata Object Additional metadata about the firmographic record.
markaaz.firmographic.metadata.hasCompanyHierarchy String Indicates whether the business has associated company hierarchy data available.

Business Hierarchy

Field Type Description
markaaz Object Root response object.
markaaz.traceId String Trace ID for the request.
markaaz.markaazId String Markaaz ID of the business. Max 16 chars.
markaaz.epInternalId String Partner's internal business identifier, echoed back. Max 250 chars.
markaaz.bizInfo Object Company details for the business.
markaaz.bizInfo.dba String Doing Business As name. Max 1000 chars.
markaaz.bizInfo.legalName String Business legal name. Max 1000 chars.
markaaz.bizInfo.taxId String Business Tax ID. Max 100 chars.
markaaz.bizInfo.nationalId String National ID. Max 500 chars.
markaaz.bizInfo.addresses Array
 Addresses on file for the business.
markaaz.bizInfo.addresses[].type String Address type (e.g., Primary, Registered, Secondary).
markaaz.bizInfo.addresses[].line1 String First line of the address.
markaaz.bizInfo.addresses[].line2 String Second line of the address.
markaaz.bizInfo.addresses[].locality String City in which the business is based.
markaaz.bizInfo.addresses[].region String State/region in which the business is based.
markaaz.bizInfo.addresses[].postalCode String Postal code of the business address.
markaaz.bizInfo.addresses[].country String Country where the business is based.
markaaz.bizInfo.addresses[].latitude String Latitude of the business location.
markaaz.bizInfo.addresses[].longitude String Longitude of the business location.
markaaz.bizInfo.addresses[].geoprecision String Precision level of the geocoded location.
markaaz.bizInfo.addresses[].businessIndicator String Indicator of whether the address is a business location.
markaaz.bizInfo.addresses[].residentialIndicator String Indicator of whether the address is residential.
markaaz.bizInfo.addresses[].sohoIndicator String Small office/home office indicator.
markaaz.companyHierarchy Array List of entities in the business's corporate hierarchy.
markaaz.companyHierarchy[].parentMarkaazId String Markaaz ID of the parent entity. Max 16 chars.
markaaz.companyHierarchy[].markaazId String Markaaz ID of this hierarchy entity. Max 16 chars.
markaaz.companyHierarchy[].companyLegalName String Legal name of this hierarchy entity. Max 200 chars.
markaaz.companyHierarchy[].contact Object Contact details for this hierarchy entity.
markaaz.companyHierarchy[].contact.phoneNumber String Phone number. Max 15 chars.
markaaz.companyHierarchy[].contact.countryCallingCode String Country calling code. Max 15 chars.
markaaz.companyHierarchy[].contact.website String Website. Max 150 chars.
markaaz.companyHierarchy[].parentTypeCode Integer Code identifying the type of parent relationship.
markaaz.companyHierarchy[].companyName String Name of this hierarchy entity. Max 200 chars.
markaaz.companyHierarchy[].addresses Object Address for this hierarchy entity.
markaaz.companyHierarchy[].addresses.type String Address type. Max 100 chars.
markaaz.companyHierarchy[].addresses.line1 String First line of the address. Max 500 chars.
markaaz.companyHierarchy[].addresses.line2 String Second line of the address. Max 500 chars.
markaaz.companyHierarchy[].addresses.locality String City in which the entity is based. Max 500 chars.
markaaz.companyHierarchy[].addresses.region String State/region in which the entity is based. Max 500 chars.
markaaz.companyHierarchy[].addresses.regionAbbreviation String Abbreviated state/region code. Max 100 chars.
markaaz.companyHierarchy[].addresses.country String Country in which the entity is based. Max 100 chars.
markaaz.companyHierarchy[].addresses.postalCode String Postal code of the entity's address. Max 200 chars.

Business Health

Field Type Description
markaaz Object Root response object.
markaaz.traceId String (UUID4) Trace ID for the request.
markaaz.markaazId String Markaaz ID of the business.
markaaz.epInternalId String Partner's internal business identifier, echoed back. Not stored by Matching. Max 250 chars.
markaaz.bizInfo Object Business info for the business.
markaaz.bizInfo.dba String Doing Business As name. Max 1000 chars.
markaaz.bizInfo.legalName String Business legal name. Max 1000 chars.
markaaz.bizInfo.taxId String Business Tax ID. Max 100 chars.
markaaz.bizInfo.nationalId String National ID. Max 500 chars.
markaaz.bizInfo.addresses Array
 Addresses on file for the business.
markaaz.bizInfo.addresses[].type String Address type (e.g., Primary, Registered, Secondary).
markaaz.bizInfo.addresses[].line1 String First line of the address.
markaaz.bizInfo.addresses[].line2 String Second line of the address.
markaaz.bizInfo.addresses[].locality String City in which the business is based.
markaaz.bizInfo.addresses[].region String State/region in which the business is based.
markaaz.bizInfo.addresses[].postalCode String Postal code of the business address.
markaaz.bizInfo.addresses[].country String Country where the business is based.
markaaz.bizInfo.addresses[].latitude String Latitude of the business location.
markaaz.bizInfo.addresses[].longitude String Longitude of the business location.
markaaz.bizInfo.addresses[].geoprecision String Precision level of the geocoded location.
markaaz.bizInfo.addresses[].businessIndicator String Indicator of whether the address is a business location.
markaaz.bizInfo.addresses[].residentialIndicator String Indicator of whether the address is residential.
markaaz.bizInfo.addresses[].sohoIndicator String Small office/home office indicator.
markaaz.businessHealth Object Business health details.
markaaz.businessHealth.bankruptcy String Bankruptcy indicator.
markaaz.businessHealth.markaazFailureRiskScore Integer Predicts the likelihood of the business ceasing operations with a loss to creditors within 12 months. Scored 1–9 (0 indicates bankruptcy). Higher = higher likelihood of failure; lower = lower likelihood of failure.
markaaz.businessHealth.markaazCreditRiskScore Integer Measures the risk of the business becoming severely delinquent within 12 months. Scored 103–600. Higher values indicate lower chances of severe delinquency; 0 indicates bankruptcy on file; values above 500 are considered a good credit risk score.
markaaz.businessHealth.markaazGlobalCreditRiskScore Integer A normalized business credit risk score that accounts for the variety of credit risk score ranges found globally.

P2B Match

Field Type Description
markaaz Object Root response object.
markaaz.traceId String (UUID) Trace ID for the request.
markaaz.markaazId String (UUID) Markaaz ID of the business.
markaaz.epInternalId String Partner's internal business identifier, echoed back. Not stored by Matching. Max 250 chars.
markaaz.bizInfo Object Business info for the business.
markaaz.bizInfo.dba String Doing Business As name. Max 1000 chars.
markaaz.bizInfo.legalName String Business legal name. Max 1000 chars.
markaaz.bizInfo.taxId String Business Tax ID. Max 100 chars.
markaaz.bizInfo.nationalId String National ID. Max 500 chars.
markaaz.bizInfo.addresses Array
 Addresses on file for the business.
markaaz.bizInfo.addresses[].type String Address type (e.g., Primary, Registered, Secondary).
markaaz.bizInfo.addresses[].line1 String First line of the address.
markaaz.bizInfo.addresses[].line2 String Second line of the address.
markaaz.bizInfo.addresses[].locality String City in which the business is based.
markaaz.bizInfo.addresses[].region String State/region in which the business is based.
markaaz.bizInfo.addresses[].postalCode String Postal code of the business address.
markaaz.bizInfo.addresses[].country String Country where the business is based.
markaaz.bizInfo.addresses[].latitude String Latitude of the business location.
markaaz.bizInfo.addresses[].longitude String Longitude of the business location.
markaaz.bizInfo.addresses[].geoprecision String Precision level of the geocoded location.
markaaz.bizInfo.addresses[].businessIndicator String Indicator of whether the address is a business location.
markaaz.bizInfo.addresses[].residentialIndicator String Indicator of whether the address is residential.
markaaz.bizInfo.addresses[].sohoIndicator String Small office/home office indicator.
markaaz.nameMatchResults Array Results of matching each submitted name against the business's officers.
markaaz.nameMatchResults[].matched String Indicates whether the submitted name was matched.
markaaz.nameMatchResults[].message String Result message for this name match.
markaaz.nameMatchResults[].nameMatchRequested String The name as submitted for matching.
markaaz.nameMatchResults[].nameMatched String The matched name on file, if any.
markaaz.nameMatchResults[].officerId String Identifier of the matched officer, if any.
markaaz.nameMatchResults[].matchGrade Integer Numeric grade indicating match strength.
markaaz.primaryContact Object Primary contact on file for the business.
markaaz.primaryContact.fullName String Primary contact full name.
markaaz.primaryContact.titleCode String Primary contact title code.
markaaz.primaryContact.title String Primary contact title.
markaaz.primaryContact.firstName String Primary contact first name.
markaaz.primaryContact.lastName String Primary contact last name.
markaaz.primaryContact.email String Primary contact email address.
markaaz.officers Array All officers/principals on file for the business.
markaaz.officers[].officerId String Unique identifier for the officer. Max 100 chars.
markaaz.officers[].fullName String Officer full name. Max 100 chars.
markaaz.officers[].title String Officer title. Max 100 chars.
markaaz.officers[].position String Officer position. Max 100 chars.
markaaz.officers[].currentStatus String Officer's current status (e.g., active, former). Max 100 chars.

Financial Data

Field Type Description
markaaz Object Root response object.
markaaz.traceId String Trace ID for the request.
markaaz.markaazId String Markaaz ID of the business. Max 16 chars.
markaaz.epInternalId String Partner's internal business identifier, echoed back. Not stored by Matching. Max 250 chars.
markaaz.bizInfo Object Business info for the business.
markaaz.bizInfo.dba String Doing Business As name. Max 1000 chars.
markaaz.bizInfo.legalName String Business legal name. Max 1000 chars.
markaaz.bizInfo.taxId String Business Tax ID. Max 100 chars.
markaaz.bizInfo.nationalId String National ID. Max 500 chars.
markaaz.bizInfo.addresses Array
 Addresses on file for the business.
markaaz.bizInfo.addresses[].type String Address type (e.g., Primary, Registered, Secondary).
markaaz.bizInfo.addresses[].line1 String First line of the address.
markaaz.bizInfo.addresses[].line2 String Second line of the address.
markaaz.bizInfo.addresses[].locality String City in which the business is based.
markaaz.bizInfo.addresses[].region String State/region in which the business is based.
markaaz.bizInfo.addresses[].postalCode String Postal code of the business address.
markaaz.bizInfo.addresses[].country String Country where the business is based.
markaaz.bizInfo.addresses[].latitude String Latitude of the business location.
markaaz.bizInfo.addresses[].longitude String Longitude of the business location.
markaaz.bizInfo.addresses[].geoprecision String Precision level of the geocoded location.
markaaz.bizInfo.addresses[].businessIndicator String Indicator of whether the address is a business location.
markaaz.bizInfo.addresses[].residentialIndicator String Indicator of whether the address is residential.
markaaz.bizInfo.addresses[].sohoIndicator String Small office/home office indicator.
markaaz.financialStatements Array List of financial statements on file for the business (typically one per fiscal year).
markaaz.financialStatements[].yearEndDate String Fiscal year end date for this statement.
markaaz.financialStatements[].conversionDate String Date used for any currency conversion applied.
markaaz.financialStatements[].conversionRate Number Currency conversion rate applied, if convertCurrency was requested.
markaaz.financialStatements[].numberOfWeeks Integer Number of weeks covered by the statement period.
markaaz.financialStatements[].currency String Currency of the reported figures.
markaaz.financialStatements[].consolidatedAccounts Boolean Whether the statement reflects consolidated accounts.
markaaz.financialStatements[].profitAndLoss Object Profit & loss statement figures.
markaaz.financialStatements[].profitAndLoss.revenue Number Revenue.
markaaz.financialStatements[].profitAndLoss.operatingCosts Number Operating costs.
markaaz.financialStatements[].profitAndLoss.operatingProfit Number Operating profit.
markaaz.financialStatements[].profitAndLoss.wagesAndSalaries Number Wages and salaries.
markaaz.financialStatements[].profitAndLoss.pensionCosts Number Pension costs.
markaaz.financialStatements[].profitAndLoss.depreciation Number Depreciation.
markaaz.financialStatements[].profitAndLoss.amortisation Number Amortisation.
markaaz.financialStatements[].profitAndLoss.financialIncome Number Financial income.
markaaz.financialStatements[].profitAndLoss.financialExpenses Number Financial expenses.
markaaz.financialStatements[].profitAndLoss.extraordinaryIncome Number Extraordinary income.
markaaz.financialStatements[].profitAndLoss.extraordinaryCosts Number Extraordinary costs.
markaaz.financialStatements[].profitAndLoss.profitBeforeTax Number Profit before tax.
markaaz.financialStatements[].profitAndLoss.tax Number Tax.
markaaz.financialStatements[].profitAndLoss.profitAfterTax Number Profit after tax.
markaaz.financialStatements[].profitAndLoss.dividends Number Dividends.
markaaz.financialStatements[].profitAndLoss.minorityInterests Number Minority interests.
markaaz.financialStatements[].profitAndLoss.otherAppropriations Number Other appropriations.
markaaz.financialStatements[].profitAndLoss.retainedProfit Number Retained profit.
markaaz.financialStatements[].balanceSheet Object Balance sheet figures.
markaaz.financialStatements[].balanceSheet.landAndBuildings Number Land and buildings.
markaaz.financialStatements[].balanceSheet.plantAndMachinery Number Plant and machinery.
markaaz.financialStatements[].balanceSheet.otherTangibleAssets Number Other tangible assets.
markaaz.financialStatements[].balanceSheet.totalTangibleAssets Number Total tangible assets.
markaaz.financialStatements[].balanceSheet.goodwill Number Goodwill.
markaaz.financialStatements[].balanceSheet.otherIntangibleAssets Number Other intangible assets.
markaaz.financialStatements[].balanceSheet.totalIntangibleAssets Number Total intangible assets.
markaaz.financialStatements[].balanceSheet.investments Number Investments.
markaaz.financialStatements[].balanceSheet.loansToGroup Number Loans to group.
markaaz.financialStatements[].balanceSheet.otherLoans Number Other loans.
markaaz.financialStatements[].balanceSheet.miscellaneousFixedAssets Number Miscellaneous fixed assets.
markaaz.financialStatements[].balanceSheet.totalOtherFixedAssets Number Total other fixed assets.
markaaz.financialStatements[].balanceSheet.totalFixedAssets Number Total fixed assets.
markaaz.financialStatements[].balanceSheet.rawMaterials Number Raw materials.
markaaz.financialStatements[].balanceSheet.workInProgress Number Work in progress.
markaaz.financialStatements[].balanceSheet.finishedGoods Number Finished goods.
markaaz.financialStatements[].balanceSheet.otherInventories Number Other inventories.
markaaz.financialStatements[].balanceSheet.totalInventories Number Total inventories.
markaaz.financialStatements[].balanceSheet.tradeReceivables Number Trade receivables.
markaaz.financialStatements[].balanceSheet.groupReceivables Number Group receivables.
markaaz.financialStatements[].balanceSheet.receivablesDueAfter1Year Number Receivables due after one year.
markaaz.financialStatements[].balanceSheet.miscellaneousReceivables Number Miscellaneous receivables.
markaaz.financialStatements[].balanceSheet.totalReceivables Number Total receivables.
markaaz.financialStatements[].balanceSheet.cash Number Cash.
markaaz.financialStatements[].balanceSheet.otherCurrentAssets Number Other current assets.
markaaz.financialStatements[].balanceSheet.totalCurrentAssets Number Total current assets.
markaaz.financialStatements[].balanceSheet.totalAssets Number Total assets.
markaaz.financialStatements[].balanceSheet.tradePayables Number Trade payables.
markaaz.financialStatements[].balanceSheet.bankLiabilities Number Bank liabilities.
markaaz.financialStatements[].balanceSheet.otherLoansOrFinance Number Other loans or finance.
markaaz.financialStatements[].balanceSheet.groupPayables Number Group payables.
markaaz.financialStatements[].balanceSheet.miscellaneousLiabilities Number Miscellaneous liabilities.
markaaz.financialStatements[].balanceSheet.totalCurrentLiabilities Number Total current liabilities.
markaaz.financialStatements[].balanceSheet.tradePayablesDueAfter1Year Number Trade payables due after one year.
markaaz.financialStatements[].balanceSheet.bankLiabilitiesDueAfter1Year Number Bank liabilities due after one year.
markaaz.financialStatements[].balanceSheet.otherLoansOrFinanceDueAfter1Year Number Other loans or finance due after one year.
markaaz.financialStatements[].balanceSheet.groupPayablesDueAfter1Year Number Group payables due after one year.
markaaz.financialStatements[].balanceSheet.miscellaneousLiabilitiesDueAfter1Year Number Miscellaneous liabilities due after one year.
markaaz.financialStatements[].balanceSheet.totalLongTermLiabilities Number Total long-term liabilities.
markaaz.financialStatements[].balanceSheet.totalLiabilities Number Total liabilities.
markaaz.financialStatements[].balanceSheet.calledUpShareCapital Number Called-up share capital.
markaaz.financialStatements[].balanceSheet.sharePremium Number Share premium.
markaaz.financialStatements[].balanceSheet.revenueReserves Number Revenue reserves.
markaaz.financialStatements[].balanceSheet.otherReserves Number Other reserves.
markaaz.financialStatements[].balanceSheet.totalShareholdersEquity Number Total shareholders' equity.
markaaz.financialStatements[].otherFinancials Object Additional financial figures not part of the standard P&L/balance sheet.
markaaz.financialStatements[].otherFinancials.contingentLiabilities String Contingent liabilities.
markaaz.financialStatements[].otherFinancials.workingCapital Number Working capital.
markaaz.financialStatements[].otherFinancials.netWorth Number Net worth.
markaaz.financialStatements[].ratios Object Financial ratios derived from the statement.
markaaz.financialStatements[].ratios.preTaxProfitMargin Number Pre-tax profit margin.
markaaz.financialStatements[].ratios.returnOnCapitalEmployed Number Return on capital employed.
markaaz.financialStatements[].ratios.returnOnTotalAssetsEmployed Number Return on total assets employed.
markaaz.financialStatements[].ratios.returnOnNetAssetsEmployed Number Return on net assets employed.
markaaz.financialStatements[].ratios.salesOrNetWorkingCapital Integer Sales-to-net-working-capital ratio.
markaaz.financialStatements[].ratios.stockTurnoverRatio Number Stock turnover ratio.
markaaz.financialStatements[].ratios.debtorDays Number Debtor days.
markaaz.financialStatements[].ratios.creditorDays Number Creditor days.
markaaz.financialStatements[].ratios.currentRatio Number Current ratio.
markaaz.financialStatements[].ratios.liquidityRatioOrAcidTest Number Liquidity ratio (acid test).
markaaz.financialStatements[].ratios.currentDebtRatio Number Current debt ratio.
markaaz.financialStatements[].ratios.gearing Number Gearing ratio.
markaaz.financialStatements[].ratios.equityInPercentage Number Equity as a percentage of total capital.
markaaz.financialStatements[].ratios.totalDebtRatio Number Total debt ratio.

Updated 3 days ago

Did this page help you?

Yes

No

Copy Page