> ## 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 KYC certificate data for a consumer



## OpenAPI

````yaml POST /v1/products/kyc_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/kyc_certificate/query:
    post:
      tags:
        - KYC Certificate
      summary: Query consolidated KYC certificate data for a consumer
      operationId: kyc_certificate_query_v1_products_kyc_certificate_query_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KYCCertificateQueryInput'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KYCCertificateQueryOutput'
        '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:
    KYCCertificateQueryInput:
      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.
        consumer_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Consumer Id
          description: >-
            Consumer profile primary key (Consumer.id) for permissible-purpose
            (FCRA) queries.
      type: object
      required:
        - network_ids
      title: KYCCertificateQueryInput
    KYCCertificateQueryOutput:
      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
        consumer_id:
          type: string
          format: uuid
          title: Consumer Id
        result:
          $ref: '#/components/schemas/KYCCertificateNetworkResult'
          description: Consolidated certificate resolution across all queried networks.
      type: object
      required:
        - consumer_id
        - result
      title: KYCCertificateQueryOutput
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    KYCCertificateNetworkResult:
      properties:
        meta:
          $ref: '#/components/schemas/QueryResolutionMeta'
        document_capture:
          anyOf:
            - $ref: '#/components/schemas/DocumentCaptureSubProduct'
            - type: 'null'
        document_review:
          anyOf:
            - $ref: '#/components/schemas/DocumentReviewSubProduct'
            - type: 'null'
        biometric_capture:
          anyOf:
            - $ref: '#/components/schemas/BiometricCaptureSubProduct'
            - type: 'null'
        biometric_review:
          anyOf:
            - $ref: '#/components/schemas/BiometricReviewSubProduct'
            - type: 'null'
        liveness_capture:
          anyOf:
            - $ref: '#/components/schemas/LivenessCaptureSubProduct'
            - type: 'null'
        liveness_review:
          anyOf:
            - $ref: '#/components/schemas/LivenessReviewSubProduct'
            - type: 'null'
        address_capture:
          anyOf:
            - $ref: '#/components/schemas/AddressCaptureSubProduct'
            - type: 'null'
        address_verification:
          anyOf:
            - $ref: '#/components/schemas/AddressVerificationSubProduct'
            - type: 'null'
        identity_corroboration:
          anyOf:
            - $ref: '#/components/schemas/IdentityCorroborationSubProduct'
            - type: 'null'
      type: object
      required:
        - meta
      title: KYCCertificateNetworkResult
    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
    DocumentCaptureSubProduct:
      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/DocumentCaptureAssertions'
        data:
          $ref: '#/components/schemas/DocumentCaptureData'
      type: object
      required:
        - assertions
        - data
      title: DocumentCaptureSubProduct
    DocumentReviewSubProduct:
      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/DocumentReviewAssertions'
        data:
          $ref: '#/components/schemas/DocumentReviewData'
      type: object
      required:
        - assertions
        - data
      title: DocumentReviewSubProduct
    BiometricCaptureSubProduct:
      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/BiometricCaptureAssertions'
        data:
          $ref: '#/components/schemas/BiometricCaptureData'
      type: object
      required:
        - assertions
        - data
      title: BiometricCaptureSubProduct
    BiometricReviewSubProduct:
      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/BiometricReviewAssertions'
        data:
          $ref: '#/components/schemas/BiometricReviewData'
      type: object
      required:
        - assertions
        - data
      title: BiometricReviewSubProduct
    LivenessCaptureSubProduct:
      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/LivenessCaptureAssertions'
        data:
          $ref: '#/components/schemas/LivenessCaptureData'
      type: object
      required:
        - assertions
        - data
      title: LivenessCaptureSubProduct
    LivenessReviewSubProduct:
      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/LivenessReviewAssertions'
        data:
          $ref: '#/components/schemas/LivenessReviewData'
      type: object
      required:
        - assertions
        - data
      title: LivenessReviewSubProduct
    AddressCaptureSubProduct:
      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/AddressCaptureAssertions'
        data:
          $ref: '#/components/schemas/AddressCaptureData'
      type: object
      required:
        - assertions
        - data
      title: AddressCaptureSubProduct
    AddressVerificationSubProduct:
      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/AddressVerificationAssertions'
        data:
          $ref: '#/components/schemas/AddressVerificationData'
      type: object
      required:
        - assertions
        - data
      title: AddressVerificationSubProduct
    IdentityCorroborationSubProduct:
      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/IdentityCorroborationAssertions'
        data:
          $ref: '#/components/schemas/IdentityCorroborationData'
      type: object
      required:
        - assertions
        - data
      title: IdentityCorroborationSubProduct
    DocumentCaptureAssertions:
      properties:
        document_capture_assertion:
          type: boolean
          title: Document Capture Assertion
        document_capture_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Document Capture Timestamp
      type: object
      required:
        - document_capture_assertion
      title: DocumentCaptureAssertions
    DocumentCaptureData:
      properties:
        document_artifact:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Artifact
        document_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Type
        document_issuing_state:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Issuing State
        document_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Number
        document_issue_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Issue Date
        document_expiration_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Expiration Date
        document_capture_method:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Capture Method
      type: object
      title: DocumentCaptureData
    DocumentReviewAssertions:
      properties:
        document_attribute_review_assertion:
          type: boolean
          title: Document Attribute Review Assertion
        document_attribute_review_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Document Attribute Review Timestamp
      type: object
      required:
        - document_attribute_review_assertion
      title: DocumentReviewAssertions
    DocumentReviewData:
      properties:
        document_review_method:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Review Method
        document_tamper_review_performed:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Document Tamper Review Performed
        document_tamper_indicators_observed:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Document Tamper Indicators Observed
        is_document_machine_readable_data_validation_performed:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Document Machine Readable Data Validation Performed
        is_document_machine_readable_data_validation_consistent_with_document_face:
          anyOf:
            - type: boolean
            - type: 'null'
          title: >-
            Is Document Machine Readable Data Validation Consistent With
            Document Face
      type: object
      title: DocumentReviewData
    BiometricCaptureAssertions:
      properties:
        biometric_capture_assertion:
          type: boolean
          title: Biometric Capture Assertion
        biometric_capture_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Biometric Capture Timestamp
      type: object
      required:
        - biometric_capture_assertion
      title: BiometricCaptureAssertions
    BiometricCaptureData:
      properties:
        biometric_artifact:
          anyOf:
            - type: string
            - type: 'null'
          title: Biometric Artifact
        biometric_capture_method:
          anyOf:
            - type: string
            - type: 'null'
          title: Biometric Capture Method
      type: object
      title: BiometricCaptureData
    BiometricReviewAssertions:
      properties:
        biometric_review_assertion:
          type: boolean
          title: Biometric Review Assertion
        biometric_review_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Biometric Review Timestamp
      type: object
      required:
        - biometric_review_assertion
      title: BiometricReviewAssertions
    BiometricReviewData:
      properties:
        biometric_image_quality_sufficient_for_comparison:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Biometric Image Quality Sufficient For Comparison
        biometric_comparison_reference:
          anyOf:
            - type: string
            - type: 'null'
          title: Biometric Comparison Reference
        biometric_comparison_outcome:
          anyOf:
            - type: string
            - type: 'null'
          title: Biometric Comparison Outcome
      type: object
      title: BiometricReviewData
    LivenessCaptureAssertions:
      properties:
        liveness_capture_assertion:
          type: boolean
          title: Liveness Capture Assertion
        liveness_capture_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Liveness Capture Timestamp
      type: object
      required:
        - liveness_capture_assertion
      title: LivenessCaptureAssertions
    LivenessCaptureData:
      properties:
        liveness_artifact:
          anyOf:
            - type: string
            - type: 'null'
          title: Liveness Artifact
        liveness_capture_environment:
          anyOf:
            - type: string
            - type: 'null'
          title: Liveness Capture Environment
      type: object
      title: LivenessCaptureData
    LivenessReviewAssertions:
      properties:
        liveness_review_assertion:
          type: boolean
          title: Liveness Review Assertion
        liveness_review_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Liveness Review Timestamp
      type: object
      required:
        - liveness_review_assertion
      title: LivenessReviewAssertions
    LivenessReviewData:
      properties:
        liveness_review_method:
          anyOf:
            - type: string
            - type: 'null'
          title: Liveness Review Method
        liveness_review_outcome:
          anyOf:
            - type: string
            - type: 'null'
          title: Liveness Review Outcome
        liveness_review_confidence_tier:
          anyOf:
            - type: string
            - type: 'null'
          title: Liveness Review Confidence Tier
      type: object
      title: LivenessReviewData
    AddressCaptureAssertions:
      properties:
        address_capture_assertion:
          type: boolean
          title: Address Capture Assertion
        address_capture_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Address Capture Timestamp
      type: object
      required:
        - address_capture_assertion
      title: AddressCaptureAssertions
    AddressCaptureData:
      properties:
        address_category:
          anyOf:
            - type: string
            - type: 'null'
          title: Address Category
      type: object
      title: AddressCaptureData
    AddressVerificationAssertions:
      properties:
        address_verification_assertion:
          type: boolean
          title: Address Verification Assertion
        address_verification_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Address Verification Timestamp
      type: object
      required:
        - address_verification_assertion
      title: AddressVerificationAssertions
    AddressVerificationData:
      properties:
        address_verification_methods:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Address Verification Methods
        address_verification_outcomes:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Address Verification Outcomes
        total_address_sources_consulted:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Address Sources Consulted
        address_source_count_full_match:
          anyOf:
            - type: integer
            - type: 'null'
          title: Address Source Count Full Match
        address_source_count_inconclusive:
          anyOf:
            - type: integer
            - type: 'null'
          title: Address Source Count Inconclusive
        address_source_count_no_match:
          anyOf:
            - type: integer
            - type: 'null'
          title: Address Source Count No Match
        address_source_count_partial_match_street_and_city_only:
          anyOf:
            - type: integer
            - type: 'null'
          title: Address Source Count Partial Match Street And City Only
        address_source_count_partial_match_zip_only:
          anyOf:
            - type: integer
            - type: 'null'
          title: Address Source Count Partial Match Zip Only
      type: object
      title: AddressVerificationData
    IdentityCorroborationAssertions:
      properties:
        is_identity_corroboration_performed:
          type: boolean
          title: Is Identity Corroboration Performed
        identity_corroboration_timestamp:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Identity Corroboration Timestamp
      type: object
      required:
        - is_identity_corroboration_performed
      title: IdentityCorroborationAssertions
    IdentityCorroborationData:
      properties:
        identity_elements_corroborated:
          anyOf:
            - type: string
            - type: 'null'
          title: Identity Elements Corroborated
        identity_corroboration_methods:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Identity Corroboration Methods
        identity_corroboration_outcomes:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Identity Corroboration Outcomes
        total_identity_corroboration_sources_consulted:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Identity Corroboration Sources Consulted
        identity_corroboration_source_count_full_match:
          anyOf:
            - type: integer
            - type: 'null'
          title: Identity Corroboration Source Count Full Match
        identity_corroboration_source_count_inconclusive:
          anyOf:
            - type: integer
            - type: 'null'
          title: Identity Corroboration Source Count Inconclusive
        identity_corroboration_source_count_no_match:
          anyOf:
            - type: integer
            - type: 'null'
          title: Identity Corroboration Source Count No Match
        identity_corroboration_source_count_partial_match:
          anyOf:
            - type: integer
            - type: 'null'
          title: Identity Corroboration Source Count Partial Match
      type: object
      title: IdentityCorroborationData
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````