Skip to main content
POST
/
certificates
/
kyb
/
query
Query consolidated KYB certificate data for a business
curl --request POST \
  --url https://api.example.com/certificates/kyb/query \
  --header 'Content-Type: application/json' \
  --data '
{
  "consent_id": "<string>",
  "business_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "query_event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "business_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "business_identity_verification": {
    "furnishing_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "attestation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assertions": {
      "business_identity_verification_assertion": true,
      "business_identity_verification_performed_timestamp": "2023-11-07T05:31:56Z"
    },
    "data": {
      "business_formation_document_artifact": "<string>",
      "business_dba_name": "<string>",
      "business_website_url": "<string>",
      "business_jurisdiction_of_formation": "<string>",
      "business_registration_identifier": "<string>",
      "business_identity_verification_sources": [
        "<string>"
      ],
      "business_entity_type": "<string>",
      "business_registration_status": "<string>",
      "business_operational_existence_status": "<string>",
      "business_tax_id_validation_result": "<string>",
      "business_address_verification_result": "<string>",
      "business_registered_address": {
        "line_1": "<string>",
        "line_2": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zip": "<string>",
        "country": "<string>"
      },
      "business_operating_address": {
        "line_1": "<string>",
        "line_2": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zip": "<string>",
        "country": "<string>"
      }
    }
  },
  "business_ownership_control_verification": {
    "furnishing_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "attestation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assertions": {
      "business_ownership_control_verification_assertion": true,
      "business_ownership_control_verification_timestamp": "2023-11-07T05:31:56Z"
    },
    "data": {
      "business_ownership_evidence_artifact": "<string>",
      "business_dba_name": "<string>",
      "business_website_url": "<string>",
      "business_jurisdiction_of_formation": "<string>",
      "business_registration_identifier": "<string>",
      "business_ownership_control_verification_overall_primary_source": "<string>",
      "business_authority_determination_basis": "<string>",
      "business_authorized_representatives_identified_count": 123,
      "business_beneficial_owners_identified_count": 123,
      "business_beneficial_ownership_determination_method": "<string>",
      "business_beneficial_ownership_threshold_applied": "<string>",
      "business_control_authority_evidence_reviewed_type": "<string>",
      "business_control_determination_basis": "<string>",
      "business_control_persons_identified_count": 123,
      "business_ownership_control_verification_overall_status": "<string>",
      "business_ownership_evidence_reviewed_type": "<string>"
    }
  },
  "business_risk_compliance_assessment": {
    "furnishing_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "attestation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assertions": {
      "business_risk_compliance_verification_assertion": true,
      "business_risk_compliance_timestamp": "2023-11-07T05:31:56Z"
    },
    "data": {
      "business_dba_name": "<string>",
      "business_website_url": "<string>",
      "business_jurisdiction_of_formation": "<string>",
      "business_registration_identifier": "<string>",
      "business_primary_activity_classification_code": "<string>",
      "business_primary_activity_classification_system": "<string>",
      "business_activity_risk_level": "<string>",
      "business_adverse_media_assessment_result": "<string>",
      "business_compliance_screening_scope_applied": "<string>",
      "business_restricted_activity_assessment_result": "<string>",
      "business_risk_compliance_assessment_overall_primary_source": "<string>",
      "business_risk_compliance_assessment_overall_status": "<string>",
      "business_risk_compliance_assessment_timestamp": "2023-11-07T05:31:56Z",
      "business_sanctions_screening_result": "<string>"
    }
  }
}

Body

application/json

Consent token — system resolves identity + applies field access filtering.

business_entity_id
string<uuid> | null

Direct entity lookup for permissible-purpose (FCRA) queries.

Response

Successful Response

query_event_id
string<uuid>
required
business_entity_id
string<uuid>
required
business_identity_verification
BusinessIdentityVerificationSubProduct · object
business_ownership_control_verification
BusinessOwnershipControlVerificationSubProduct · object
business_risk_compliance_assessment
BusinessRiskComplianceAssessmentSubProduct · object