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

# Search using Crypto

> Allows searching for Politically Exposed Entities and sanctions/crime records using cryptocurrency wallets and assets as the query. Supports an optional 'advancedSearch' object (firstName, lastName, position, keyword, gender, country, education) to streamline the search, as described on the Advanced Filters sub-page for this endpoint.



## OpenAPI

````yaml /api-reference/specs/quickcheck.json post /v2/api/verifications/advanced/crypto/aml-checks
openapi: 3.0.3
info:
  title: Youverify Quick Check API
  version: 2.0.0
  description: >-
    All Quick Check endpoints (KYC identity verification by country, KYB
    business verification by country, and AML/watchlist screening). Assembled
    from doc.youverify.co/api-reference-sdk/api-reference/quick-check, endpoints
    kept in the exact order they appear in the GitBook navigation. Some
    endpoints (address-verification "create a candidate" / "get states" /
    "retrieve" / "history") are documented twice in the source docs — once for
    individuals under KYC, once for businesses under KYB — and are the exact
    same request/response shape. They appear ONCE here (at their first, KYC,
    position) tagged with both sections so the file stays valid OpenAPI.


    Account-wide error responses (401, 429, 500 on every endpoint; 402 on paid
    verification calls; 404 on lookup-by-ID calls) are sourced verbatim from
    Youverify's own "Youverify OS Error Codes" and "Response Codes" pages
    (doc.youverify.co/youverify-os-error-codes, /get-started/response-codes) and
    attached via components.responses, since those pages document them
    account-wide rather than per endpoint. Any error example that a specific
    endpoint's own page actually showed is kept exactly as documented there
    instead of being replaced by these.
  contact:
    name: Youverify Support
    email: support@youverify.co
servers:
  - url: https://api.youverify.co
    description: Production (live, billed)
  - url: https://api.sandbox.youverify.co
    description: Sandbox (test data, not billed)
security:
  - ApiKeyAuth: []
tags:
  - name: KYC - Global
    description: Identity data-matching endpoints that work across countries.
  - name: KYC - South Africa
    description: South Africa-specific identity, phone and bank verification.
  - name: KYC - Kenya
    description: Kenya-specific identity, phone, bank, credit and employment verification.
  - name: KYC - Ghana
    description: Ghana-specific identity verification (passport, SSNIT, voter's card).
  - name: KYC - Nigeria
    description: >-
      Nigeria-specific identity, phone, bank and credit verification (BVN, NIN,
      etc).
  - name: KYC - Cote D'Ivoire
    description: Cote D'Ivoire-specific national ID and residence card verification.
  - name: KYC - General
    description: >-
      Identity retrieval, history and facial comparison, not tied to one
      country.
  - name: KYC - Address Verification (Individuals)
    description: >-
      Physical and digital address verification workflows for individuals. Note:
      these same endpoints are also documented under KYB for businesses — see
      merge notes.
  - name: KYB - Global
    description: >-
      Business search, bulk-upload and premium company-search endpoints not tied
      to one country.
  - name: KYB - Nigeria
    description: Nigeria-specific business address verification and tax ID checks.
  - name: KYB - South Africa
    description: South Africa-specific business account and address verification.
  - name: KYB - Cote D'Ivoire
    description: Cote D'Ivoire-specific company filings lookup.
  - name: AML Screening
    description: PEP, sanctions, adverse-media and crypto AML screening.
  - name: AML Watchlist
    description: Manage your own custom AML watchlist.
paths:
  /v2/api/verifications/advanced/crypto/aml-checks:
    post:
      tags:
        - AML Screening
      summary: Search using Crypto
      description: >-
        Allows searching for Politically Exposed Entities and sanctions/crime
        records using cryptocurrency wallets and assets as the query. Supports
        an optional 'advancedSearch' object (firstName, lastName, position,
        keyword, gender, country, education) to streamline the search, as
        described on the Advanced Filters sub-page for this endpoint.
      operationId: searchUsingCrypto
      parameters:
        - name: token
          in: header
          required: true
          schema:
            type: string
          description: API secret token
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: Crypto ID of the subject to query with
                isSubjectConsent:
                  type: boolean
                  description: Indicate subject has given consent. Must be true
                type:
                  type: string
                  description: Entity type
                  enum:
                    - all
                advancedSearch:
                  type: object
                  description: Contains features that can streamline your search
                  properties:
                    firstName:
                      type: string
                      description: First name of subject
                    lastName:
                      type: string
                      description: Last name of subject
                    position:
                      type: string
                      description: Position of subject
                    keyword:
                      type: string
                      description: Keywords related to the subject
                    gender:
                      type: string
                      description: Gender of subject
                    country:
                      type: string
                      description: Country of subject
                    education:
                      type: string
                      description: Subject's education
              required:
                - query
                - isSubjectConsent
                - type
            example:
              type: all
              query: 1P7A3tqZTBXt8zfTfJPkiNZCRFJkUV5N9R
              isSubjectConsent: 'true'
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                success: true
                statusCode: 200
                message: success
                data:
                  status: review_required
                  parentId: null
                  isSubjectConsent: true
                  type: all
                  sanctions: []
                  pep: []
                  crime:
                    - title:
                        - 1P7A3tqZTBXt8zfTfJPkiNZCRFJkUV5N9R
                      entityType: CryptoWallet
                      datasets:
                        - ransomwhere
                      alias:
                        - Locky
                      publicKey:
                        - 1P7A3tqZTBXt8zfTfJPkiNZCRFJkUV5N9R
                      balance:
                        - '100000000.00'
                      amountUsd:
                        - '422.37'
                      currency:
                        - bitcoin
                      topics:
                        - crime.theft
                  debarment: []
                  financial_services: []
                  government: []
                  role: []
                  religion: []
                  military: []
                  frozen_asset: []
                  personOfInterest: []
                  totalEntity: 1
                  categoryCount:
                    sanctions: 0
                    pep: 0
                    crime: 1
                    debarment: 0
                    financial_services: 0
                    government: 0
                    role: 0
                    religion: 0
                    military: 0
                    frozen_asset: 0
                    personOfInterest: 0
                  queriedWith: Crypto Id
                  query: 1P7A3tqZTBXt8zfTfJPkiNZCRFJkUV5N9R
                  businessId: 62b2e8b281442b03187f7896
                  requestedAt: '2023-08-11T03:57:49.394Z'
                  requestedById: 62b2e8b381442b75857f7898
                  createdAt: '2023-08-11T03:57:49.584Z'
                  lastModifiedAt: '2023-08-11T03:57:49.584Z'
                  id: 64d5c0119b0cdca3fbe26536
                  requestedBy:
                    firstName: API
                    lastName: User
                    middleName: ''
                    id: 628b38f03ae28a5a122d4bf3
                links: []
        '401':
          $ref: '#/components/responses/Error401Unauthorized'
        '402':
          $ref: '#/components/responses/Error402PaymentRequired'
        '429':
          $ref: '#/components/responses/Error429TooManyRequests'
        '500':
          $ref: '#/components/responses/Error500ServerError'
components:
  responses:
    Error401Unauthorized:
      description: Unauthorized — the token header is missing or invalid.
      content:
        application/json:
          example:
            success: false
            statusCode: 401
            message: Permission denied
            name: UnauthorizedError
            data: {}
    Error402PaymentRequired:
      description: Payment Required — your account balance is too low to run this check.
      content:
        application/json:
          example:
            success: false
            statusCode: 402
            message: Insufficient fund
            name: PaymentRequiredError
            data: {}
    Error429TooManyRequests:
      description: Too Many Requests — you have exceeded the rate limit; wait and retry.
      content:
        application/json:
          example:
            success: false
            statusCode: 429
            message: Too many requests
            name: RateLimitError
            data: {}
    Error500ServerError:
      description: >-
        Internal Server Error — a rare, unexpected failure on Youverify's side.
        Contact support@youverify.co if it persists.
      content:
        application/json:
          example:
            success: false
            statusCode: 500
            message: Internal Server Error
            name: Error
            data: {}
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: token
      description: Your Youverify API secret key. Never expose client-side.

````