> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solo.one/llms.txt
> Use this file to discover all available pages before exploring further.

# Query consolidated KYB certificate data for a business



## OpenAPI

````yaml POST /v1/products/kyb_certificate/query
openapi: 3.1.0
info:
  title: SOLO Network API
  version: v1
servers:
  - url: https://api.solo.one
    description: Production
  - url: https://api.sandbox.solo.one
    description: Sandbox
security: []
paths:
  /v1/products/kyb_certificate/query:
    post:
      tags:
        - KYB Certificate
      summary: Query consolidated KYB certificate data for a business
      operationId: kyb_certificate_query_v1_products_kyb_certificate_query_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KYBCertificateQueryInput'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KYBCertificateQueryOutput'
        '204':
          description: >-
            No certificate could be created — the available data did not satisfy
            the policy requirements.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    KYBCertificateQueryInput:
      properties:
        policy_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Policy Id
          description: >-
            Querying policy applied across every network in network_ids. If
            omitted, each network's default policy is used.
        network_ids:
          items:
            type: string
            format: uuid
          type: array
          minItems: 1
          title: Network Ids
          description: >-
            Networks to query across; the single policy is applied to all of
            them.
        furnishing_entity_ids:
          anyOf:
            - items:
                type: string
                format: uuid
              type: array
            - type: 'null'
          title: Furnishing Entity Ids
          description: >-
            Optional furnishing-entity scope. When omitted or empty, data from
            all furnishers is considered.
        consent_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Consent Id
          description: >-
            Consent token — system resolves identity + applies field access
            filtering.
        business_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Business Id
          description: >-
            Business profile primary key (Business.id) for permissible-purpose
            (FCRA) queries.
      type: object
      required:
        - network_ids
      title: KYBCertificateQueryInput
    KYBCertificateQueryOutput:
      properties:
        certificate_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Certificate Id
        query_event_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Query Event Id
        business_id:
          type: string
          format: uuid
          title: Business Id
        result:
          $ref: '#/components/schemas/KYBCertificateNetworkResult'
          description: Consolidated certificate resolution across all queried networks.
      type: object
      required:
        - business_id
        - result
      title: KYBCertificateQueryOutput
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    KYBCertificateNetworkResult:
      properties:
        meta:
          $ref: '#/components/schemas/QueryResolutionMeta'
        business_identity_verification:
          anyOf:
            - $ref: '#/components/schemas/BusinessIdentityVerificationSubProduct'
            - type: 'null'
        business_ownership_control_verification:
          anyOf:
            - $ref: >-
                #/components/schemas/BusinessOwnershipControlVerificationSubProduct
            - type: 'null'
        business_risk_compliance_assessment:
          anyOf:
            - $ref: '#/components/schemas/BusinessRiskComplianceAssessmentSubProduct'
            - type: 'null'
      type: object
      required:
        - meta
      title: KYBCertificateNetworkResult
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    QueryResolutionMeta:
      properties:
        network_id:
          type: string
          format: uuid
          title: Network Id
        policy_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Policy Id
      type: object
      required:
        - network_id
      title: QueryResolutionMeta
    BusinessIdentityVerificationSubProduct:
      properties:
        furnishing_entity_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Furnishing Entity Id
        attestation_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Attestation Id
        assertions:
          $ref: '#/components/schemas/BusinessIdentityVerificationAssertions'
        data:
          $ref: '#/components/schemas/BusinessIdentityVerificationData'
      type: object
      required:
        - assertions
        - data
      title: BusinessIdentityVerificationSubProduct
    BusinessOwnershipControlVerificationSubProduct:
      properties:
        furnishing_entity_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Furnishing Entity Id
        attestation_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Attestation Id
        assertions:
          $ref: '#/components/schemas/BusinessOwnershipControlVerificationAssertions'
        data:
          $ref: '#/components/schemas/BusinessOwnershipControlVerificationData'
      type: object
      required:
        - assertions
        - data
      title: BusinessOwnershipControlVerificationSubProduct
    BusinessRiskComplianceAssessmentSubProduct:
      properties:
        furnishing_entity_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Furnishing Entity Id
        attestation_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Attestation Id
        assertions:
          $ref: '#/components/schemas/BusinessRiskComplianceAssessmentAssertions'
        data:
          $ref: '#/components/schemas/BusinessRiskComplianceAssessmentData'
      type: object
      required:
        - assertions
        - data
      title: BusinessRiskComplianceAssessmentSubProduct
    BusinessIdentityVerificationAssertions:
      properties:
        business_identity_verification_assertion:
          type: boolean
          title: Business Identity Verification Assertion
        business_identity_verification_performed_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Business Identity Verification Performed Timestamp
      type: object
      required:
        - business_identity_verification_assertion
      title: BusinessIdentityVerificationAssertions
    BusinessIdentityVerificationData:
      properties:
        business_formation_document_artifact:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Formation Document Artifact
        business_dba_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Dba Name
        business_website_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Website Url
        business_jurisdiction_of_formation:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Jurisdiction Of Formation
        business_registration_identifier:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Registration Identifier
        business_identity_verification_sources:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Business Identity Verification Sources
        business_entity_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Entity Type
        business_registration_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Registration Status
        business_operational_existence_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Operational Existence Status
        business_tax_id_validation_result:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Tax Id Validation Result
        business_address_verification_result:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Address Verification Result
        business_registered_address:
          anyOf:
            - $ref: '#/components/schemas/BusinessAddressOutput'
            - type: 'null'
        business_operating_address:
          anyOf:
            - $ref: '#/components/schemas/BusinessAddressOutput'
            - type: 'null'
      type: object
      title: BusinessIdentityVerificationData
    BusinessOwnershipControlVerificationAssertions:
      properties:
        business_ownership_control_verification_assertion:
          type: boolean
          title: Business Ownership Control Verification Assertion
        business_ownership_control_verification_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Business Ownership Control Verification Timestamp
      type: object
      required:
        - business_ownership_control_verification_assertion
      title: BusinessOwnershipControlVerificationAssertions
    BusinessOwnershipControlVerificationData:
      properties:
        business_ownership_evidence_artifact:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Ownership Evidence Artifact
        business_dba_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Dba Name
        business_website_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Website Url
        business_jurisdiction_of_formation:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Jurisdiction Of Formation
        business_registration_identifier:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Registration Identifier
        business_ownership_control_verification_overall_primary_source:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Ownership Control Verification Overall Primary Source
        business_authority_determination_basis:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Authority Determination Basis
        business_authorized_representatives_identified_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Business Authorized Representatives Identified Count
        business_beneficial_owners_identified_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Business Beneficial Owners Identified Count
        business_beneficial_ownership_determination_method:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Beneficial Ownership Determination Method
        business_beneficial_ownership_threshold_applied:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Beneficial Ownership Threshold Applied
        business_control_authority_evidence_reviewed_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Control Authority Evidence Reviewed Type
        business_control_determination_basis:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Control Determination Basis
        business_control_persons_identified_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Business Control Persons Identified Count
        business_ownership_control_verification_overall_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Ownership Control Verification Overall Status
        business_ownership_evidence_reviewed_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Ownership Evidence Reviewed Type
      type: object
      title: BusinessOwnershipControlVerificationData
    BusinessRiskComplianceAssessmentAssertions:
      properties:
        business_risk_compliance_verification_assertion:
          type: boolean
          title: Business Risk Compliance Verification Assertion
        business_risk_compliance_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Business Risk Compliance Timestamp
      type: object
      required:
        - business_risk_compliance_verification_assertion
      title: BusinessRiskComplianceAssessmentAssertions
    BusinessRiskComplianceAssessmentData:
      properties:
        business_dba_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Dba Name
        business_website_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Website Url
        business_jurisdiction_of_formation:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Jurisdiction Of Formation
        business_registration_identifier:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Registration Identifier
        business_primary_activity_classification_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Primary Activity Classification Code
        business_primary_activity_classification_system:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Primary Activity Classification System
        business_activity_risk_level:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Activity Risk Level
        business_adverse_media_assessment_result:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Adverse Media Assessment Result
        business_compliance_screening_scope_applied:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Compliance Screening Scope Applied
        business_restricted_activity_assessment_result:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Restricted Activity Assessment Result
        business_risk_compliance_assessment_overall_primary_source:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Risk Compliance Assessment Overall Primary Source
        business_risk_compliance_assessment_overall_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Risk Compliance Assessment Overall Status
        business_risk_compliance_assessment_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Business Risk Compliance Assessment Timestamp
        business_sanctions_screening_result:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Sanctions Screening Result
      type: object
      title: BusinessRiskComplianceAssessmentData
    BusinessAddressOutput:
      properties:
        line_1:
          anyOf:
            - type: string
            - type: 'null'
          title: Line 1
        line_2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line 2
        city:
          anyOf:
            - type: string
            - type: 'null'
          title: City
        state:
          anyOf:
            - type: string
            - type: 'null'
          title: State
        zip:
          anyOf:
            - type: string
            - type: 'null'
          title: Zip
        country:
          anyOf:
            - type: string
            - type: 'null'
          title: Country
      type: object
      title: BusinessAddressOutput
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````