Response

For every Business Verification (KYB) run, AiPrise returns a single, structured response that includes:

• Final verification decision
• Workflow execution status
• Business, registry, ownership, and AML details
• Related persons and companies
• Metadata for traceability and callbacks

High-level Response Structure

For all business verifications (KYB, AML, Custom Templates), AiPrise returns the following top-level keys:

aiprise_summary

Provides the final KYB decision.

aiprise_summary: {
  verification_result: "APPROVED | DECLINED | REVIEW | UNKNOWN"
}

Verification Results

status

Represents the execution state of the KYB workflow.

status_reasons

Returned only when status = FAILED.

status_reasons: [
  {
    "code": "API_DATA_REQUIREMENTS_NOT_MET",
    "message": "Invalid business data. tax_identification_number missing."
  }
]

📘

Full list available in Status Error Codes.

business_input

Contains the input data submitted for the KYB session.

Core Fields

• name – Legal business name
• alternate_name – DBA or trade name
• tax_identification_number
• website
• formation_date (YYYY-MM-DD)
• country_code (ISO-2)
• state_code
• business_entity_id

Contact & Address

• addresses[]
• phone_numbers[]
• email_addresses[]

Questionnaires & Documents

• questions_response
• additional_info[] (bank statements, licenses, incorporation docs, policies, etc.)

business_info

Contains enriched and extracted business data.

registration_info

Registry and incorporation details.

Includes:

• formation_date
• status (active, dissolved, etc.)
• registration_records[] per jurisdiction
• Registry source name and URL
• Registered addresses

related_persons

Directors, officers, shareholders, and UBOs.

Each entry includes:

• Personal details (name, DOB)
• Ownership percentage & shares
• Roles (title, start/end date)
• Contact details
• Address
• Linked KYC session (if run)

related_companies

V1 (Basic)

Related businesses such as subsidiaries or parent companies:

• Name, status, description
• Ownership percentage
• Addresses

V2 (Multi-Level Business Profile Enabled)

Each related company becomes a Business Profile with:

• Profile ID & result
• KYB/KYC history
• Risk info
• Callback URLs
• Full business attributes

website_info

Insights derived from the company’s website.

events

Business lifecycle or regulatory events.

Examples:

• Registration
• Dissolution
• Ownership change

Each event includes:

• date
• event_type
• metadata

lookup_info

Data fetched from public or government sources.

Includes:

• Source name
• Lookup title
• Raw extracted data

aml_info

AML screening results for the business.

Summary Fields

• result
• status
• num_hits
• warnings

Entity Hits

Each hit may include:

• Match confidence scores
• Hit types (PEP, SANCTION, ADVERSE_MEDIA, etc.)
• Source metadata
• Media references

Identifiers & Metadata