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

# Get Verification

> Get KYB Verification Detail

Returns detailed verification results including officers, liens, and watchlist hits.



## OpenAPI

````yaml https://api.stuut.ai/openapi.json get /v2/partners/{partner_id}/kyb/{verification_id}
openapi: 3.1.0
info:
  title: Stuut API
  termsOfService: https://stuut.ai/terms-and-conditions
  contact:
    name: Stuut Support
    url: https://stuut.ai/
    email: devs@stuut.co
  version: 2.0.0
servers: []
security:
  - HTTPBearer: []
tags:
  - name: adjustments
    description: Operations for managing payment adjustments (fees, discounts, write-offs).
    x-displayName: Adjustments
  - name: aether
    description: Operations for aether.
    x-displayName: Aether
  - name: analytics
    description: Operations for retrieving analytics and dashboard data.
    x-displayName: Analytics
  - name: assistant
    description: Operations for the in-app chat assistant.
    x-displayName: Assistant
  - name: audit-log
    description: Operations for retrieving the organization's audit log.
    x-displayName: Audit Log
  - name: bank-accounts
    description: Operations for retrieving and managing bank accounts.
    x-displayName: Bank Accounts
  - name: bank-statements
    description: Operations for retrieving and managing bank statements.
    x-displayName: Bank Statements
  - name: bank-transactions
    description: Operations for retrieving and managing bank transactions.
    x-displayName: Bank Transactions
  - name: business-units
    description: Operations for listing and managing business units.
    x-displayName: Business Units
  - name: call-agent
    description: >-
      Operations for initiating and managing real-time voice calls with
      partners.
    x-displayName: Call Agent
  - name: calls
    description: Operations for retrieving and managing voice call records.
    x-displayName: Calls
  - name: cash-app
    description: Operations for cash application — matching incoming payments to invoices.
    x-displayName: Cash Application
  - name: chats
    description: Operations for managing chat conversations.
    x-displayName: Chats
  - name: cnam-registration
    description: Operations for managing CNAM (caller ID name) registration.
    x-displayName: CNAM Registration
  - name: credit-memos
    description: Operations for retrieving and searching credit memos.
    x-displayName: Credit Memos
  - name: custom-table-templates
    description: >-
      Operations for managing custom table templates used in email template
      variables.
    x-displayName: Custom Table Templates
  - name: customer-segments
    description: Operations for managing customer segments.
    x-displayName: Customer Segments
  - name: deductions-knowledge
    description: Operations for managing deduction processing knowledge entries.
    x-displayName: Deductions Knowledge
  - name: email-threads
    description: Operations for managing email threads.
    x-displayName: Email Threads
  - name: emails
    description: Operations for retrieving and managing emails.
    x-displayName: Emails
  - name: exports
    description: Operations for requesting and retrieving async data exports.
    x-displayName: Exports
  - name: integrations
    description: >-
      Operations for managing integrations with external systems (e.g. ERP, CRM,
      etc.).
    x-displayName: Integrations
  - name: internal-contacts
    description: >-
      Operations for managing internal contacts (CSMs, account managers, etc.)
      and their assignments to partners.
    x-displayName: Internal Contacts
  - name: invoices
    description: Operations for retrieving and managing invoices.
    x-displayName: Invoices
  - name: kyb
    description: Operations for Know Your Business (KYB) verification.
    x-displayName: KYB
  - name: ledger-accounts
    description: Operations for retrieving and managing ledger accounts.
    x-displayName: Ledger Accounts
  - name: mailbox-settings
    description: >-
      Operations for an organization's mailbox provider configuration: Microsoft
      admin consent, shared-mailbox discovery, and provider health.
    x-displayName: Mailbox Settings
  - name: mailboxes
    description: >-
      Operations for connecting, listing, updating, and archiving user and
      shared mailboxes, including delegated OAuth sign-in.
    x-displayName: Mailboxes
  - name: media
    description: >-
      Operations for signing direct-to-storage media uploads (e.g. signature
      images).
    x-displayName: Media
  - name: organizations
    description: Operations for retrieving and managing the current organization.
    x-displayName: Organizations
  - name: outreach-workflows
    description: Operations for managing automated collections outreach workflows.
    x-displayName: Outreach Workflows
  - name: partners
    description: Operations for retrieving and managing customers.
    x-displayName: Partners
  - name: payments
    description: Operations for approving and managing payments.
    x-displayName: Payments
  - name: report-configs
    description: >-
      Operations for managing report configurations (frequency, recipients,
      schedule).
    x-displayName: Report Configs
  - name: sms-campaign-registration
    description: Operations for managing A2P 10DLC SMS campaign registration.
    x-displayName: SMS Campaign Registration
  - name: sms-templates
    description: >-
      Operations for defining, storing, and managing parameterized SMS message
      templates.
    x-displayName: SMS Templates
  - name: sms-threads
    description: Operations for retrieving and managing SMS conversation threads.
    x-displayName: SMS Threads
  - name: users
    description: Operations for retrieving and managing users.
    x-displayName: Users
  - name: users-ooo
    description: Operations for managing user out-of-office (OOO) status and coverage.
    x-displayName: Users OOO
paths:
  /v2/partners/{partner_id}/kyb/{verification_id}:
    get:
      tags:
        - kyb
      summary: Get Verification
      description: >-
        Get KYB Verification Detail


        Returns detailed verification results including officers, liens, and
        watchlist hits.
      operationId: GetPartnersPartnerIdKybVerificationId
      parameters:
        - name: partner_id
          in: path
          required: true
          schema:
            type: string
        - name: verification_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KYBVerificationDetail'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    KYBVerificationDetail:
      properties:
        created_at:
          type: string
          format: date-time
          title: ''
        modified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: ''
        id:
          type: string
          title: ''
        status:
          $ref: '#/components/schemas/VerificationStatus'
          title: ''
          description: Current status of the verification request.
        verification_type:
          $ref: '#/components/schemas/VerificationType'
          title: ''
          description: The type of verification performed.
        requested_at:
          type: string
          format: date-time
          title: ''
          description: When the verification was requested.
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: ''
          description: When the verification completed (success or failure).
        is_verified:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: >-
            Overall verification result - True if business is verified, False if
            not, None if pending.
        verification_rating:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: >-
            Verification quality rating (A, B, C, F). Null if vendor doesn't
            provide.
        risk_rating:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Risk assessment rating (A, B, C, F). Null if vendor doesn't provide.
        error_message:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Error message if verification failed.
        verification_score:
          anyOf:
            - type: integer
            - type: 'null'
          title: ''
          description: Verification quality score (0-100). Null if vendor doesn't provide.
        risk_score:
          anyOf:
            - type: integer
            - type: 'null'
          title: ''
          description: Risk assessment score (0-100). Null if vendor doesn't provide.
        sos_status:
          anyOf:
            - $ref: '#/components/schemas/SosStatus'
            - type: 'null'
          title: ''
          description: Secretary of State registration status.
        sos_standing:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: >-
            SOS standing (e.g., 'GOOD STANDING', 'SUSPENDED'). Distinct from
            sos_status.
        sos_file_number:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Secretary of State filing/file number.
        registration_type:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: SOS registration type (e.g., 'domestic', 'foreign').
        registered_name:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: >-
            Official business name on the SOS registration (may differ from
            search name).
        business_structure:
          anyOf:
            - $ref: '#/components/schemas/BusinessStructure'
            - type: 'null'
          title: ''
          description: Legal structure of the business (LLC, Corporation, Sole Prop, etc.).
        business_address:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Legal entity address as reported by vendor.
        formation_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: ''
          description: Date the business was formed/incorporated.
        inactive_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: ''
          description: Date the business became inactive, if applicable.
        dissolution_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: ''
          description: Date the business was dissolved, if applicable.
        domestic_state:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Two-letter state code where business is domiciled.
        registered_agent_name:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Name of the registered/statutory agent.
        registered_agent_address:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: ''
          description: Full address of the registered agent (street, city, state, zip).
        alternative_names:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: ''
          description: Alternate business names / DBAs from official records.
        registered_address:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: ''
          description: Full registered address from SOS records (street, city, state, zip).
        name_verified:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: Whether the business name was verified against official records.
        name_match_quality:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: >-
            Raw name match quality from vendor (e.g., 'EXACT', 'PARTIAL',
            'NO_MATCH').
        address_verified:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: Whether the business address was verified.
        address_match_quality:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: >-
            Raw address match quality from vendor (e.g., 'EXACT', 'PARTIAL',
            'NO_MATCH').
        tin_verified:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: Whether the Tax ID (TIN/EIN) was verified with IRS records.
        address_type:
          anyOf:
            - $ref: '#/components/schemas/BusinessAddressType'
            - type: 'null'
          title: ''
          description: USPS address classification (street, PO box, CMRA, etc.).
        is_residential:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if address is classified as residential (RDI indicator).
        naics_code:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: 6-digit NAICS industry code.
        mcc_code:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: 4-digit Merchant Category Code.
        sic_code:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: 4-digit Standard Industrial Classification code.
        industry_description:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Human-readable industry description.
        industry_confidence:
          anyOf:
            - type: number
            - type: 'null'
          title: ''
          description: Industry prediction confidence score (0.0-1.0).
        naics_risk_level:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: NAICS risk level from prediction (e.g. 'high', 'medium', 'low').
        mcc_codes:
          anyOf:
            - items:
                $ref: '#/components/schemas/KYBIndustryCode'
              type: array
            - type: 'null'
          title: ''
          description: All predicted MCC codes from vendor [{code, description}, ...].
        sic_codes:
          anyOf:
            - items:
                $ref: '#/components/schemas/KYBIndustryCode'
              type: array
            - type: 'null'
          title: ''
          description: All predicted SIC codes from vendor [{code, description}, ...].
        industry_keywords:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: ''
          description: Industry classification keywords from NAICS prediction.
        industry_reasoning:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: LLM reasoning for the NAICS industry classification.
        website_url:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Discovered or verified business website URL.
        domain_age_days:
          anyOf:
            - type: integer
            - type: 'null'
          title: ''
          description: Age of the domain in days.
        has_ssl:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: Whether the website has a valid SSL certificate.
        email_deliverable:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: Whether email to the business domain is deliverable.
        officer_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: ''
          description: Number of officers discovered.
        officer_match:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if any provided officer name matched discovered officers.
        active_lien_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: ''
          description: Total count of active liens (UCC, tax, judgment).
        active_ucc_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: ''
          description: Count of active UCC filings.
        tax_lien_found:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if any tax liens (federal or state) were found.
        judgment_found:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if any judgment liens were found.
        watchlist_clear:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: >-
            True if no hits on any sanctions/watchlists. False if any hits
            found.
        ofac_clear:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if no OFAC (SDN, SSI, etc.) hits found.
        pep_found:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if any Politically Exposed Person matches found.
        registrations:
          items:
            $ref: '#/components/schemas/KYBRegistrationSummary'
          type: array
          title: ''
          description: SoS registrations across all states.
        addresses:
          items:
            $ref: '#/components/schemas/KYBAddressSummary'
          type: array
          title: ''
          description: Addresses associated with the business.
        officers:
          items:
            $ref: '#/components/schemas/KYBOfficerSummary'
          type: array
          title: ''
          description: Officers discovered during verification.
        liens:
          items:
            $ref: '#/components/schemas/KYBLienSummary'
          type: array
          title: ''
          description: Liens and filings discovered during verification.
        watchlist_hits:
          items:
            $ref: '#/components/schemas/KYBWatchlistHitSummary'
          type: array
          title: ''
          description: Watchlist/sanctions matches found during verification.
        website_analysis_detail:
          anyOf:
            - $ref: '#/components/schemas/KYBWebsiteAnalysisSummary'
            - type: 'null'
          title: ''
          description: Detailed website analysis data from online presence verification.
        input_data:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: ''
          description: >-
            The data sent to the vendor for verification (business_name, tax_id,
            address, etc.).
        object:
          type: string
          title: ''
          description: >-
            String representing the object's type. Objects of the same type
            share the same value.
          readOnly: true
      type: object
      required:
        - created_at
        - modified_at
        - id
        - status
        - verification_type
        - requested_at
        - completed_at
        - is_verified
        - verification_rating
        - risk_rating
        - error_message
        - verification_score
        - risk_score
        - sos_status
        - sos_standing
        - sos_file_number
        - registration_type
        - registered_name
        - business_structure
        - business_address
        - formation_date
        - inactive_date
        - dissolution_date
        - domestic_state
        - registered_agent_name
        - registered_agent_address
        - alternative_names
        - registered_address
        - name_verified
        - name_match_quality
        - address_verified
        - address_match_quality
        - tin_verified
        - address_type
        - is_residential
        - naics_code
        - mcc_code
        - sic_code
        - industry_description
        - industry_confidence
        - naics_risk_level
        - mcc_codes
        - sic_codes
        - industry_keywords
        - industry_reasoning
        - website_url
        - domain_age_days
        - has_ssl
        - email_deliverable
        - officer_count
        - officer_match
        - active_lien_count
        - active_ucc_count
        - tax_lien_found
        - judgment_found
        - watchlist_clear
        - ofac_clear
        - pep_found
        - registrations
        - addresses
        - officers
        - liens
        - watchlist_hits
        - website_analysis_detail
        - input_data
        - object
      title: KYBVerificationDetail
      description: Full KYB verification details.
    HTTPValidationError:
      $defs:
        ValidationError:
          properties:
            loc:
              items:
                anyOf:
                  - type: string
                  - type: integer
              title: Location
              type: array
            msg:
              title: Message
              type: string
            type:
              title: Type
              type: string
          required:
            - loc
            - msg
            - type
          title: ValidationError
          type: object
          x-speakeasy-include: true
      properties:
        type:
          const: request-validation
          title: Type
          type: string
        detail:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: Human-readable description of this specific problem.
          title: Detail
          x-speakeasy-error-message: true
        status:
          const: 422
          title: Status
          type: integer
        title:
          description: Short human-readable summary of the problem.
          title: Title
          type: string
          x-speakeasy-error-message: true
        errors:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Errors
          type: array
      required:
        - type
        - status
        - title
        - errors
      title: APIError
      type: object
    VerificationStatus:
      type: string
      enum:
        - pending
        - in_progress
        - completed
        - failed
      title: VerificationStatus
      description: Status of a business verification request.
    VerificationType:
      type: string
      enum:
        - business_search
        - online_presence
        - lien_search
        - docket_search
        - comprehensive
      title: VerificationType
      description: Type of business verification to perform.
    SosStatus:
      type: string
      enum:
        - active
        - inactive
        - dissolved
        - suspended
        - forfeited
        - withdrawn
        - merged
        - converted
        - unknown
      title: SosStatus
      description: Secretary of State registration status.
    BusinessStructure:
      type: string
      enum:
        - llc
        - corporation
        - sole_proprietorship
        - partnership
        - limited_partnership
        - llp
        - nonprofit
        - professional_corporation
        - trust
        - cooperative
        - other
      title: BusinessStructure
      description: Legal structure of the business.
    BusinessAddressType:
      type: string
      enum:
        - street
        - high_rise
        - po_box
        - rural_route
        - general_delivery
        - cmra
        - virtual_office
      title: BusinessAddressType
      description: USPS address classification and risk indicators.
    KYBIndustryCode:
      properties:
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
        visa_risk_tier:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
        mastercard_risk:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
      type: object
      required:
        - code
        - description
        - visa_risk_tier
        - mastercard_risk
      title: KYBIndustryCode
      description: A single industry classification code.
    KYBRegistrationSummary:
      properties:
        created_at:
          type: string
          format: date-time
          title: ''
        modified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: ''
        id:
          type: string
          title: ''
        registration_type:
          type: string
          title: ''
          description: Registration type from SoS (e.g., 'domestic', 'foreign').
        state:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Two-letter state code for this registration.
        status:
          anyOf:
            - $ref: '#/components/schemas/SosStatus'
            - type: 'null'
          title: ''
          description: Secretary of State registration status.
        standing:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: SOS standing (e.g., 'Good Standing', 'Suspended').
        file_number:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Secretary of State filing/file number.
        registered_name:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Business name as registered in this state.
        issue_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: ''
          description: Date the registration was issued.
        inactive_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: ''
          description: Date the registration became inactive, if applicable.
        dissolution_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: ''
          description: Date the business was dissolved in this state, if applicable.
        registered_agent_name:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Name of the registered/statutory agent in this state.
        registered_agent_address:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: ''
          description: Full address of the registered agent (street, city, state, zip).
        registered_address:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: ''
          description: Registered address in this state (street, city, state, zip).
        object:
          type: string
          title: ''
          description: >-
            String representing the object's type. Objects of the same type
            share the same value.
          readOnly: true
      type: object
      required:
        - created_at
        - modified_at
        - id
        - registration_type
        - state
        - status
        - standing
        - file_number
        - registered_name
        - issue_date
        - inactive_date
        - dissolution_date
        - registered_agent_name
        - registered_agent_address
        - registered_address
        - object
      title: KYBRegistrationSummary
      description: SoS registration discovered during verification.
    KYBAddressSummary:
      properties:
        created_at:
          type: string
          format: date-time
          title: ''
        modified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: ''
        id:
          type: string
          title: ''
        street:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Street address line.
        city:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: City name.
        state:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Two-letter state code.
        zip:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: ZIP or postal code.
        address_type:
          anyOf:
            - $ref: '#/components/schemas/BusinessAddressType'
            - type: 'null'
          title: ''
          description: USPS address classification (street, PO box, CMRA, etc.).
        is_cmra:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if address is a Commercial Mail Receiving Agency.
        is_residential:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if address is classified as residential (RDI indicator).
        object:
          type: string
          title: ''
          description: >-
            String representing the object's type. Objects of the same type
            share the same value.
          readOnly: true
      type: object
      required:
        - created_at
        - modified_at
        - id
        - street
        - city
        - state
        - zip
        - address_type
        - is_cmra
        - is_residential
        - object
      title: KYBAddressSummary
      description: Address associated with the business.
    KYBOfficerSummary:
      properties:
        created_at:
          type: string
          format: date-time
          title: ''
        modified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: ''
        id:
          type: string
          title: ''
        name:
          type: string
          title: ''
          description: Full name of the officer.
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Officer title (CEO, Managing Member, Registered Agent, etc.).
        source:
          anyOf:
            - $ref: '#/components/schemas/OfficerSource'
            - type: 'null'
          title: ''
          description: Where this officer information was discovered.
        is_input_match:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if this officer matches a name provided in verification input.
        match_score:
          anyOf:
            - type: number
            - type: 'null'
          title: ''
          description: Fuzzy match confidence score (0.0-1.0) if matched against input.
        watchlist_clear:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if this individual has no watchlist hits.
        pep_status:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if this individual is a Politically Exposed Person.
        object:
          type: string
          title: ''
          description: >-
            String representing the object's type. Objects of the same type
            share the same value.
          readOnly: true
      type: object
      required:
        - created_at
        - modified_at
        - id
        - name
        - title
        - source
        - is_input_match
        - match_score
        - watchlist_clear
        - pep_status
        - object
      title: KYBOfficerSummary
      description: Officer discovered during verification.
    KYBLienSummary:
      properties:
        created_at:
          type: string
          format: date-time
          title: ''
        modified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: ''
        id:
          type: string
          title: ''
        filing_number:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Official filing number from the recording office.
        filing_type:
          $ref: '#/components/schemas/LienFilingType'
          title: ''
          description: Type of lien filing (UCC-1, tax lien, judgment, etc.).
        status:
          $ref: '#/components/schemas/LienStatus'
          title: ''
          description: Current status of the lien (active, terminated, lapsed).
        filed_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: ''
          description: Date the lien was filed.
        expiration_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: ''
          description: Date the lien expires or lapsed.
        secured_party:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Name of the secured party (lender). May be masked.
        is_blanket_lien:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if this is an 'all assets' blanket lien.
        collateral_description:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Description of collateral covered by the lien.
        object:
          type: string
          title: ''
          description: >-
            String representing the object's type. Objects of the same type
            share the same value.
          readOnly: true
      type: object
      required:
        - created_at
        - modified_at
        - id
        - filing_number
        - filing_type
        - status
        - filed_date
        - expiration_date
        - secured_party
        - is_blanket_lien
        - collateral_description
        - object
      title: KYBLienSummary
      description: Lien discovered during verification.
    KYBWatchlistHitSummary:
      properties:
        created_at:
          type: string
          format: date-time
          title: ''
        modified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: ''
        id:
          type: string
          title: ''
        list_type:
          $ref: '#/components/schemas/WatchlistType'
          title: ''
          description: The type of watchlist/sanctions database that matched.
        list_name:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: >-
            Specific list name if more granular than list_type (e.g., specific
            OFAC program).
        matched_name:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: >-
            The name on the watchlist that matched. Null for zero-hit
            screenings.
        match_score:
          anyOf:
            - type: number
            - type: 'null'
          title: ''
          description: Fuzzy match confidence score (0.0-1.0).
        matched_entity_type:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: >-
            What was matched: 'business' or 'officer'. Null for zero-hit
            screenings.
        matched_entity_name:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: >-
            The input name (business or officer) that triggered the match. Null
            for zero-hit screenings.
        is_false_positive:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if manually reviewed and determined to be a false positive.
        object:
          type: string
          title: ''
          description: >-
            String representing the object's type. Objects of the same type
            share the same value.
          readOnly: true
      type: object
      required:
        - created_at
        - modified_at
        - id
        - list_type
        - list_name
        - matched_name
        - match_score
        - matched_entity_type
        - matched_entity_name
        - is_false_positive
        - object
      title: KYBWatchlistHitSummary
      description: >-
        Watchlist screening result. Null match fields indicate a clean
        screening.
    KYBWebsiteAnalysisSummary:
      properties:
        created_at:
          type: string
          format: date-time
          title: ''
        modified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: ''
        id:
          type: string
          title: ''
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: The URL that was analyzed.
        parked:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: True if the domain is parked (no real content).
        email_deliverable:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: Whether email to the business domain is deliverable.
        ssl_valid:
          anyOf:
            - type: boolean
            - type: 'null'
          title: ''
          description: Whether the website has a valid SSL certificate.
        website_build_status:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: Website build status (e.g., 'active', 'parked', 'inactive').
        website_summary:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: AI-generated summary of the business from website content.
        screenshot_url:
          anyOf:
            - type: string
            - type: 'null'
          title: ''
          description: URL to a cached screenshot of the website.
        emails:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: ''
          description: Email addresses extracted from the website (JSON array of strings).
        phone_numbers:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: ''
          description: Phone numbers extracted from the website (JSON array of strings).
        social_profiles:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: ''
          description: Social media profiles found (JSON array of {site, url, username}).
        object:
          type: string
          title: ''
          description: >-
            String representing the object's type. Objects of the same type
            share the same value.
          readOnly: true
      type: object
      required:
        - created_at
        - modified_at
        - id
        - url
        - parked
        - email_deliverable
        - ssl_valid
        - website_build_status
        - website_summary
        - screenshot_url
        - emails
        - phone_numbers
        - social_profiles
        - object
      title: KYBWebsiteAnalysisSummary
      description: Website analysis data from online presence verification.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          type: string
          title: Type
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
      x-speakeasy-include: true
    OfficerSource:
      type: string
      enum:
        - sos
        - website
        - linkedin
        - input
        - other
      title: OfficerSource
      description: Source where officer information was discovered.
    LienFilingType:
      type: string
      enum:
        - ucc1
        - ucc3_continuation
        - ucc3_amendment
        - ucc3_assignment
        - ucc3_termination
        - ucc5
        - federal_tax_lien
        - state_tax_lien
        - judgment
        - mechanics_lien
        - other
      title: LienFilingType
      description: Type of lien or public filing.
    LienStatus:
      type: string
      enum:
        - active
        - terminated
        - lapsed
        - amended
      title: LienStatus
      description: Current status of a lien filing.
    WatchlistType:
      type: string
      enum:
        - ofac
        - csl
        - cns
        - fbi
        - pep
        - ieo
        - other
      title: WatchlistType
      description: Baselayer watchlist/sanctions screening codes.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````