---
updatedAt: 2026-06-03T16:27:31.000Z
agentTools:
  projectIndex: https://developer.markaaz.com/llms.txt
---

# Compliance Details

Compliance Details

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Markaaz API Services 2.0",
    "description": "Markaaz API Services 2.0",
    "termsOfService": "https://markaaz.com/terms-and-conditions/",
    "contact": {
      "email": "support@markaaz.com"
    },
    "license": {
      "name": "Copyright ©2023 Markaaz Inc. All rights reserved."
    },
    "version": "v2.0"
  },
  "security": [
    {
      "Partner_API_Key": []
    }
  ],
  "paths": {
    "/v2.0/business/compliance": {
      "post": {
        "operationId": "v2.0_business_compliance_create",
        "summary": "Compliance Details",
        "description": "Compliance Details",
        "parameters": [
          {
            "name": "x-partner-id",
            "in": "header",
            "description": "Partner Id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/VerificationRequest"
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BusinessComplianceDetailsMarkaazRootSerializerv2"
                }
              }
            }
          },
          "207": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MultiStatusWithoutConfidenceRootResponse"
                }
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BadRequestResponse"
                }
              }
            }
          },
          "403": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnAuthorizedBizResponse"
                }
              }
            }
          },
          "404": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceNotFoundResponse"
                }
              }
            }
          },
          "429": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TooManyRequestsResponse"
                }
              }
            }
          },
          "500": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerErrorBizResponse"
                }
              }
            }
          },
          "504": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayTimeoutResponse"
                }
              }
            }
          }
        },
        "tags": [
          "Markaaz Business Verification"
        ]
      },
      "parameters": []
    }
  },
  "servers": [
    {
      "url": "https://api-partner-sandbox.app.markaaz.com"
    },
    {
      "url": "http://api-partner-sandbox.app.markaaz.com"
    }
  ],
  "components": {
    "requestBodies": {
      "VerificationRequest": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/VerificationRequest"
            }
          }
        },
        "required": true
      }
    },
    "securitySchemes": {
      "Partner_API_Key": {
        "type": "apiKey",
        "description": "Partner API Key",
        "name": "x-api-key",
        "in": "header"
      }
    },
    "schemas": {
      "BadRequestResponse": {
        "required": [
          "markaaz"
        ],
        "type": "object",
        "properties": {
          "markaaz": {
            "title": "markaaz",
            "description": "Markaaz Root",
            "type": "object",
            "properties": {
              "traceId": {
                "title": "traceId",
                "description": "Trace ID (UUID)",
                "type": "string"
              },
              "message": {
                "title": "message",
                "description": "Message",
                "type": "string"
              },
              "messageId": {
                "title": "messageId",
                "description": "Message Id",
                "type": "integer"
              },
              "errors": {
                "title": "errors",
                "description": "errors",
                "type": "object"
              }
            }
          }
        },
        "title": "Bad Request Response",
        "description": "Bad Request Response Data"
      },
      "UnAuthorizedBizResponse": {
        "required": [
          "markaaz"
        ],
        "type": "object",
        "properties": {
          "markaaz": {
            "title": "markaaz",
            "description": "Markaaz Root",
            "type": "object",
            "properties": {
              "traceId": {
                "title": "traceId",
                "description": "Trace ID (UUID)",
                "type": "string"
              },
              "message": {
                "title": "message",
                "description": "Message",
                "type": "string"
              },
              "messageId": {
                "title": "messageId",
                "description": "Message Id",
                "type": "integer"
              }
            }
          }
        },
        "title": "UnAuthorized Response",
        "description": "UnAuthorized Response Data"
      },
      "ResourceNotFoundResponse": {
        "required": [
          "markaaz"
        ],
        "type": "object",
        "properties": {
          "markaaz": {
            "title": "markaaz",
            "description": "Markaaz Root",
            "type": "object",
            "properties": {
              "traceId": {
                "title": "traceId",
                "description": "Trace ID (UUID)",
                "type": "string"
              },
              "message": {
                "title": "message",
                "description": "Message",
                "type": "string"
              },
              "messageId": {
                "title": "messageId",
                "description": "Message Id",
                "type": "number"
              }
            }
          }
        },
        "title": "Resource Not Found",
        "description": "Resource Not Found or bad URL"
      },
      "TooManyRequestsResponse": {
        "required": [
          "markaaz"
        ],
        "type": "object",
        "properties": {
          "markaaz": {
            "title": "markaaz",
            "description": "Markaaz Root",
            "type": "object",
            "properties": {
              "traceId": {
                "title": "traceId",
                "description": "Trace ID (UUID)",
                "type": "string"
              },
              "message": {
                "title": "message",
                "description": "Message",
                "type": "string"
              },
              "messageId": {
                "title": "messageId",
                "description": "Message Id",
                "type": "number"
              }
            }
          }
        },
        "title": "Too Many Requests",
        "description": "Too many requests. Please try again later."
      },
      "ServerErrorBizResponse": {
        "required": [
          "markaaz"
        ],
        "type": "object",
        "properties": {
          "markaaz": {
            "title": "markaaz",
            "description": "Markaaz Root",
            "type": "object",
            "properties": {
              "traceId": {
                "title": "traceId",
                "description": "Trace ID (UUID)",
                "type": "string"
              },
              "message": {
                "title": "message",
                "description": "Message",
                "type": "string"
              },
              "messageId": {
                "title": "messageId",
                "description": "Message Id",
                "type": "number"
              },
              "errors": {
                "title": "errors",
                "description": "Errors",
                "type": "string"
              }
            }
          }
        },
        "title": "Server Error Response",
        "description": "Server Error Response Data"
      },
      "GatewayTimeoutResponse": {
        "required": [
          "markaaz"
        ],
        "type": "object",
        "properties": {
          "markaaz": {
            "title": "markaaz",
            "description": "Markaaz Root",
            "type": "object",
            "properties": {
              "traceId": {
                "title": "traceId",
                "description": "Trace ID (UUID)",
                "type": "string"
              },
              "message": {
                "title": "message",
                "description": "Message",
                "type": "string"
              },
              "messageId": {
                "title": "messageId",
                "description": "Message Id",
                "type": "integer"
              }
            }
          }
        },
        "title": "Gateway Timeout Error Response",
        "description": "Gateway Timeout Error Response Data"
      },
      "VerificationRequest": {
        "required": [
          "markaazId"
        ],
        "type": "object",
        "properties": {
          "markaazId": {
            "title": "markaazId",
            "description": "markaazId",
            "type": "string",
            "maxLength": 16
          },
          "epInternalId": {
            "title": "epInternalId",
            "description": "A unique business identifier in the partners backend system. This can be provided for easier traceability between a partner system and a Markaaz ID.",
            "type": "string",
            "maxLength": 250
          }
        }
      },
      "BusinessComplianceDetailsMarkaazRootSerializerv2": {
        "type": "object",
        "properties": {
          "markaaz": {
            "title": "Compliance Details Response",
            "description": "Compliance Detail Data",
            "type": "object",
            "properties": {
              "traceId": {
                "title": "traceId",
                "description": "Trace Id",
                "type": "string"
              },
              "markaazId": {
                "title": "markaazId",
                "description": "Markaaz Id",
                "type": "string"
              },
              "epInternalId": {
                "title": "epInternalId",
                "description": "A unique business identifier in the partners backend system. This can be provided for easier traceability between a partner system and a Markaaz ID. Matching does not store the epInternalId.",
                "type": "string",
                "maxLength": 250
              },
              "bizInfo": {
                "title": "bizInfo",
                "description": "Business Info",
                "type": "object",
                "properties": {
                  "dba": {
                    "title": "DBA",
                    "description": "Doing Business As",
                    "type": "string",
                    "maxLength": 1000
                  },
                  "legalName": {
                    "title": "legalName",
                    "description": "Business Legal Name",
                    "type": "string",
                    "maxLength": 1000
                  },
                  "taxId": {
                    "title": "taxId",
                    "description": "Business Tax Id",
                    "type": "string",
                    "maxLength": 100
                  },
                  "nationalId": {
                    "title": "nationalId",
                    "description": "National Id",
                    "type": "string",
                    "maxLength": 500
                  },
                  "addresses": {
                    "title": "addresses",
                    "description": "Addresses",
                    "type": "array",
                    "items": {
                      "title": "AddressesItem",
                      "description": "Addresses",
                      "type": "object",
                      "properties": {
                        "type": {
                          "title": "type",
                          "description": "Indicates the type of address such as Primary, Registered or Secondary.",
                          "type": "string"
                        },
                        "line1": {
                          "title": "line1",
                          "description": "The first line of the address.",
                          "type": "string"
                        },
                        "line2": {
                          "title": "line2",
                          "description": "The second line of the address",
                          "type": "string"
                        },
                        "locality": {
                          "title": "locality",
                          "description": "The locality or city in which the business is based in.",
                          "type": "string"
                        },
                        "region": {
                          "title": "region",
                          "description": "The region or state in which the business is based in.",
                          "type": "string"
                        },
                        "postalCode": {
                          "title": "postalCode",
                          "description": "The postal code of the area in which the business is based in.",
                          "type": "string"
                        },
                        "country": {
                          "title": "country",
                          "description": "The country where the business is based in.",
                          "type": "string"
                        },
                        "latitude": {
                          "title": "latitude",
                          "description": "The latitude of the location of the business.",
                          "type": "string"
                        },
                        "longitude": {
                          "title": "longitude",
                          "description": "The longitude of the location of the business.",
                          "type": "string"
                        },
                        "geoprecision": {
                          "title": "geoprecision",
                          "description": "The geoprecision field.",
                          "type": "string"
                        },
                        "businessIndicator": {
                          "title": "businessIndicator",
                          "description": "The businessIndicator field.",
                          "type": "string"
                        },
                        "residentialIndicator": {
                          "title": "residentialIndicator",
                          "description": "The residentialIndicator field.",
                          "type": "string"
                        },
                        "sohoIndicator": {
                          "title": "sohoIndicator",
                          "description": "The small office home office inidcator.",
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              },
              "complianceSummary": {
                "title": "complianceSummary",
                "description": "Compliance Summary",
                "type": "object",
                "properties": {
                  "activeSanctions": {
                    "title": "activeSanctions",
                    "description": "Active Sanctions",
                    "type": "integer"
                  },
                  "activeInsolvency": {
                    "title": "activeInsolvency",
                    "description": "Active Insolvency",
                    "type": "integer"
                  },
                  "activePoliticallyExposedPersons": {
                    "title": "activePoliticallyExposedPersons",
                    "description": "Active Politically Exposed Persons",
                    "type": "integer"
                  },
                  "activeAdverseMedia": {
                    "title": "activeAdverseMedia",
                    "description": "Active Adverse Media",
                    "type": "integer"
                  },
                  "activeLawEnforcement": {
                    "title": "activeLawEnforcement",
                    "description": "Active Law Enforcement",
                    "type": "integer"
                  }
                }
              },
              "complianceDetails": {
                "title": "complianceDetails",
                "description": "Compliance Details",
                "type": "object",
                "properties": {
                  "evidences": {
                    "title": "evidences",
                    "description": "Evidences",
                    "type": "array",
                    "items": {
                      "title": "evidence",
                      "type": "object",
                      "properties": {
                        "originalUrl": {
                          "title": "originalUrl",
                          "description": "Original Url",
                          "type": "string"
                        },
                        "credibility": {
                          "title": "credibility",
                          "description": "Credibility",
                          "type": "string"
                        },
                        "language": {
                          "title": "language",
                          "description": "Language",
                          "type": "string"
                        },
                        "evidenceId": {
                          "title": "evidenceId",
                          "description": "Evidence Id",
                          "type": "string"
                        },
                        "captureDateIso": {
                          "title": "captureDateIso",
                          "description": "Capture Date Iso",
                          "type": "string"
                        },
                        "publicationDateIso": {
                          "title": "publicationDateIso",
                          "description": "Publication Date Iso",
                          "type": "string"
                        },
                        "isCopyrighted": {
                          "title": "isCopyrighted",
                          "description": "Is Copyrighted",
                          "type": "string"
                        },
                        "assetUrl": {
                          "title": "assetUrl",
                          "description": "Asset Url",
                          "type": "string"
                        },
                        "title": {
                          "title": "title",
                          "description": "Title",
                          "type": "string"
                        },
                        "summary": {
                          "title": "summary",
                          "description": "Summary",
                          "type": "string"
                        },
                        "keywords": {
                          "title": "keywords",
                          "description": "Keywords",
                          "type": "string"
                        },
                        "datasets": {
                          "title": "datasets",
                          "description": "Datasets",
                          "type": "array",
                          "items": {
                            "title": "Dataset",
                            "description": "Dataset",
                            "type": "string"
                          }
                        }
                      }
                    }
                  },
                  "pep": {
                    "title": "pep",
                    "description": "Politicaly exposed persones",
                    "type": "array",
                    "items": {
                      "title": "pepEntries",
                      "type": "object",
                      "properties": {
                        "qrCode": {
                          "title": "qrCode",
                          "description": "Qr Code",
                          "type": "string"
                        },
                        "firstName": {
                          "title": "firstName",
                          "description": "First Name",
                          "type": "string"
                        },
                        "middleName": {
                          "title": "middleName",
                          "description": "Middle Name",
                          "type": "string"
                        },
                        "lastName": {
                          "title": "lastName",
                          "description": "Last Name",
                          "type": "string"
                        },
                        "relationship": {
                          "title": "relationship",
                          "description": "Relationship",
                          "type": "string"
                        },
                        "ownershipPercentage": {
                          "title": "ownershipPercentage",
                          "description": "Ownership Percentage",
                          "type": "string"
                        },
                        "resourceUri": {
                          "title": "resourceUri",
                          "description": "Resource Uri",
                          "type": "string"
                        },
                        "resourceId": {
                          "title": "resourceId",
                          "description": "Resource Id",
                          "type": "string"
                        },
                        "datasets": {
                          "title": "datasets",
                          "description": "Datasets",
                          "type": "array",
                          "items": {
                            "title": "Dataset",
                            "description": "Dataset",
                            "type": "string"
                          }
                        }
                      }
                    }
                  },
                  "adverseMedia": {
                    "title": "adverseMedia",
                    "description": "Adverse Media",
                    "type": "array",
                    "items": {
                      "title": "AdverseMediaItem",
                      "type": "object",
                      "properties": {
                        "category": {
                          "title": "category",
                          "description": "Category",
                          "type": "string"
                        },
                        "subcategory": {
                          "title": "subcategory",
                          "description": "Subcategory",
                          "type": "string"
                        },
                        "events": {
                          "title": "events",
                          "description": "Events",
                          "type": "array",
                          "items": {
                            "title": "event",
                            "type": "object",
                            "properties": {
                              "type": {
                                "title": "type",
                                "description": "Type",
                                "type": "string"
                              },
                              "dateIso": {
                                "title": "dateIso",
                                "description": "Date Iso",
                                "type": "string"
                              },
                              "evidenceIds": {
                                "title": "evidenceIds",
                                "description": "Evidence Ids ",
                                "type": "array",
                                "items": {
                                  "title": "Evidence Id",
                                  "type": "string"
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  },
                  "lawEnforcement": {
                    "title": "lawEnforcement",
                    "description": "Law Enforcement",
                    "type": "array",
                    "items": {
                      "title": "LawEnforcementItem",
                      "type": "object",
                      "properties": {
                        "category": {
                          "title": "category",
                          "description": "Category",
                          "type": "string"
                        },
                        "subcategory": {
                          "title": "subcategory",
                          "description": "Subcategory",
                          "type": "string"
                        },
                        "events": {
                          "title": "events",
                          "description": "Events",
                          "type": "array",
                          "items": {
                            "title": "event",
                            "type": "object",
                            "properties": {
                              "type": {
                                "title": "type",
                                "description": "Type",
                                "type": "string"
                              },
                              "currencyCode": {
                                "title": "currencyCode",
                                "description": "Currency code",
                                "type": "string"
                              },
                              "amount": {
                                "title": "amount",
                                "description": "Amount",
                                "type": "integer"
                              },
                              "period": {
                                "title": "period",
                                "description": "Period",
                                "type": "object",
                                "properties": {
                                  "days": {
                                    "title": "days",
                                    "description": "days",
                                    "type": "integer"
                                  },
                                  "years": {
                                    "title": "years",
                                    "description": "years",
                                    "type": "integer"
                                  },
                                  "months": {
                                    "title": "months",
                                    "description": "months",
                                    "type": "integer"
                                  }
                                }
                              },
                              "dateIso": {
                                "title": "dateIso",
                                "description": "Date Iso",
                                "type": "string"
                              },
                              "evidenceIds": {
                                "title": "evidenceIds",
                                "description": "Evidence Ids ",
                                "type": "array",
                                "items": {
                                  "title": "Evidence Id",
                                  "type": "string"
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  },
                  "insolvency": {
                    "title": "insolvency",
                    "description": "Insolvency",
                    "type": "array",
                    "items": {
                      "title": "InsolvencyItem",
                      "type": "object",
                      "properties": {
                        "type": {
                          "title": "type",
                          "description": "Type",
                          "type": "string"
                        },
                        "insolvencyIdNumber": {
                          "title": "insolvencyIdNumber",
                          "description": "Insolvency id number",
                          "type": "string"
                        },
                        "solicitor": {
                          "title": "solicitor",
                          "description": "Solicitor",
                          "type": "string"
                        },
                        "court": {
                          "title": "court",
                          "description": "Court",
                          "type": "string"
                        },
                        "petitioner": {
                          "title": "petitioner",
                          "description": "Petitioner",
                          "type": "string"
                        },
                        "debt": {
                          "title": "debt",
                          "description": "Debt",
                          "type": "string"
                        },
                        "accountantInBankruptcyCaseNumber": {
                          "title": "accountantInBankruptcyCaseNumber",
                          "description": "Accountant in bankruptcy case number",
                          "type": "string"
                        },
                        "insolvencyStartDateIso": {
                          "title": "insolvencyStartDateIso",
                          "description": "Insolvency start date Iso",
                          "type": "string"
                        },
                        "insolvencyEndDateIso": {
                          "title": "insolvencyEndDateIso",
                          "description": "Insolvency end date Iso",
                          "type": "string"
                        },
                        "hearingDateIso": {
                          "title": "hearingDateIso",
                          "description": "Hearing date Iso",
                          "type": "string"
                        },
                        "presentedDateOfPetitionIso": {
                          "title": "presentedDateOfPetitionIso",
                          "description": "Presented date of petition Iso",
                          "type": "string"
                        },
                        "gazetteIssueDateIso": {
                          "title": "gazetteIssueDateIso",
                          "description": "Gazette issue date Iso",
                          "type": "string"
                        },
                        "awardDateIso": {
                          "title": "awardDateIso",
                          "description": "Award date Iso",
                          "type": "string"
                        },
                        "firstOrderDateIso": {
                          "title": "firstOrderDateIso",
                          "description": "First order date Iso",
                          "type": "string"
                        },
                        "evidenceIds": {
                          "title": "evidenceIds",
                          "description": "Evidence Ids ",
                          "type": "array",
                          "items": {
                            "title": "Evidence Id",
                            "description": "Evidence Id",
                            "type": "string"
                          }
                        }
                      }
                    }
                  },
                  "sanctions": {
                    "title": "sanctions",
                    "description": "Sanctions",
                    "type": "object",
                    "properties": {
                      "current": {
                        "title": "current",
                        "description": "Current",
                        "type": "array",
                        "items": {
                          "title": "CurrentItem",
                          "type": "object",
                          "properties": {
                            "sanctionId": {
                              "title": "sanctionId",
                              "description": "Sanction Id",
                              "type": "string"
                            },
                            "measures": {
                              "title": "measures",
                              "description": "Measures",
                              "type": "array",
                              "items": {
                                "title": "measure",
                                "type": "string"
                              }
                            },
                            "regime": {
                              "title": "regime",
                              "description": "Regime",
                              "type": "object",
                              "properties": {
                                "body": {
                                  "title": "body",
                                  "description": "body",
                                  "type": "string"
                                },
                                "name": {
                                  "title": "name",
                                  "description": "name",
                                  "type": "string"
                                },
                                "origin": {
                                  "title": "origin",
                                  "description": "origin",
                                  "type": "string"
                                },
                                "types": {
                                  "title": "types",
                                  "description": "Types",
                                  "type": "array",
                                  "items": {
                                    "title": "type",
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "events": {
                              "title": "events",
                              "description": "Events",
                              "type": "array",
                              "items": {
                                "title": "event",
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "title": "type",
                                    "description": "Type",
                                    "type": "string"
                                  },
                                  "dateIso": {
                                    "title": "dateIso",
                                    "description": "Date Iso",
                                    "type": "string"
                                  },
                                  "evidenceIds": {
                                    "title": "evidenceIds",
                                    "description": "Evidence Ids ",
                                    "type": "array",
                                    "items": {
                                      "title": "Evidence Id",
                                      "type": "string"
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      },
                      "former": {
                        "title": "former",
                        "description": "Former",
                        "type": "array",
                        "items": {
                          "title": "FormerItem",
                          "type": "object",
                          "properties": {
                            "sanctionId": {
                              "title": "sanctionId",
                              "description": "Sanction Id",
                              "type": "string"
                            },
                            "measures": {
                              "title": "measures",
                              "description": "Measures",
                              "type": "array",
                              "items": {
                                "title": "measure",
                                "type": "string"
                              }
                            },
                            "regime": {
                              "title": "regime",
                              "description": "Regime",
                              "type": "object",
                              "properties": {
                                "body": {
                                  "title": "body",
                                  "description": "body",
                                  "type": "string"
                                },
                                "name": {
                                  "title": "name",
                                  "description": "name",
                                  "type": "string"
                                },
                                "origin": {
                                  "title": "origin",
                                  "description": "origin",
                                  "type": "string"
                                },
                                "types": {
                                  "title": "types",
                                  "description": "Types",
                                  "type": "array",
                                  "items": {
                                    "title": "type",
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "events": {
                              "title": "events",
                              "description": "Events",
                              "type": "array",
                              "items": {
                                "title": "event",
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "title": "type",
                                    "description": "Type",
                                    "type": "string"
                                  },
                                  "dateIso": {
                                    "title": "dateIso",
                                    "description": "Date Iso",
                                    "type": "string"
                                  },
                                  "evidenceIds": {
                                    "title": "evidenceIds",
                                    "description": "Evidence Ids ",
                                    "type": "array",
                                    "items": {
                                      "title": "Evidence Id",
                                      "type": "string"
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "title": "markaaz",
        "description": "Markaaz root"
      },
      "MultiStatusWithoutConfidenceRootResponse": {
        "type": "object",
        "properties": {
          "traceId": {
            "title": "Traceid",
            "type": "string",
            "format": "uuid"
          },
          "message": {
            "title": "Message",
            "type": "string",
            "maxLength": 200,
            "minLength": 1
          },
          "messageId": {
            "title": "Messageid",
            "type": "integer"
          }
        }
      }
    }
  }
}
```