> ## 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.

# Adverse Media Intelligence

> Performs adverse media screening checks on individuals or businesses to identify negative news, fraud, sanctions violations, and other compliance-related concerns.



## OpenAPI

````yaml /api-reference/specs/quickcheck.json post /v2/api/identity/adverse-media
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/identity/adverse-media:
    post:
      tags:
        - AML Screening
      summary: Adverse Media Intelligence
      description: >-
        Performs adverse media screening checks on individuals or businesses to
        identify negative news, fraud, sanctions violations, and other
        compliance-related concerns.
      operationId: adverseMediaIntelligence
      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: Search query can be individual name or business name
                isSubjectConsent:
                  type: boolean
                  description: Indicate subject has given consent. Must be true
                type:
                  type: string
                  description: Search query type, depends on what the query is
                  enum:
                    - individual
                    - business
                country:
                  type: array
                  description: Country codes for screening
                  items:
                    type: string
                startDate:
                  type: string
                  description: Search query start date (YYYY-MM-DD)
                endDate:
                  type: string
                  description: Search query end date (YYYY-MM-DD)
                tags:
                  type: array
                  description: Category tags to check for
                  items:
                    type: string
                  enum:
                    - untagged
                    - fraud
                    - sanction-violations
                    - money-laundering
                    - terrorism
                    - embezzlement
                    - cybercrime
                    - drug
                    - tax-evasion
                    - arms-trafficking
              required:
                - query
                - isSubjectConsent
                - type
            example:
              isSubjectConsent: true
              query: Jon Snow
              type: individual
              country:
                - us
                - ng
              tags:
                - untagged
                - fraud
                - embezzlement
              startDate: '2020-03-10'
              endDate: '2023-03-10'
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                success: true
                statusCode: 200
                message: success
                data:
                  id: 645bcc8d0326730ad94f85d4
                  query: Jon Snow
                  queryCountry:
                    - us
                    - ng
                  queryTags:
                    - untagged
                    - fraud
                    - embezzlement
                  queryStartDate: >-
                    Tue Mar 10 2020 01:00:00 GMT+0100 (West Africa Standard
                    Time)
                  queryEndDate: >-
                    Fri Mar 10 2023 01:00:00 GMT+0100 (West Africa Standard
                    Time)
                  total: 20
                  media:
                    - date: '2020-06-03 13:15:02'
                      source: >-
                        https://www.pressgazette.co.uk/jon-snow-fair-amount-of-bullshit-needed-probing-during-pandemic-channel-4-news
                      headline: >-
                        Jon Snow: There's been a 'fair amount of bullshit which
                        needed probing' during the pandemic
                      excerpt: null
                      score: 71.535
                      inferring: Negative
                      tags: []
                      language: en
                      persons:
                        - 'Jon '
                        - 'Snow '
                        - 'Jon Snow '
                      organizations:
                        - 'Snow '
                        - 'UK '
                      site: null
                      country: US
                      _id: 645bcc9e0326730ad94f85d6
                  reason: >-
                    : Kit Harington has expressed he doesn't want to take on a
                    similar role again
                  weightedScore: 66.3275
                  tagsAnalysis: []
                  parentId: null
                  status: potential-high-risk
                  businessId: 628b38f03ae28a14f52d4bf7
                  type: individual
                  requestedAt: '2023-05-10T16:55:57.854Z'
                  requestedById: 628b38f03ae28a5a122d4bf3
                  createdAt: '2023-05-10T16:55:58.261Z'
                  lastModifiedAt: '2023-05-10T16:55:58.261Z'
                  metadata: {}
                  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.

````