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

# Adverse Media

> Retrieve adverse media associated with a particular businessID



## OpenAPI

````yaml openapi/integration-service/adverse-media.json get /business/{businessID}/adverse-media
openapi: 3.1.0
info:
  title: Integration Service
  description: >-
    This service is responsible for all integrations and contains all
    integration information about the business.
  contact: {}
  version: '1.0'
servers:
  - url: https://api.joinworth.com/integration/api/v1
    variables: {}
security: []
tags:
  - name: Adverse Media
paths:
  /business/{businessID}/adverse-media:
    parameters: []
    get:
      tags:
        - Adverse Media
      summary: Adverse Media
      description: Retrieve adverse media associated with a particular businessID
      operationId: AdverseMedia
      parameters:
        - name: businessID
          in: path
          description: >-
            Unique identifier of the business whose adverse media screening
            results are being requested.
          required: true
          style: simple
          schema:
            type: string
            description: UUID of the business record in the integration service.
            examples:
              - aabbccdd-eeff-aabb-ccdd-eeffaabbccdd
      responses:
        '200':
          description: OK
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Fri, 28 Feb 2025 11:44:56 GMT
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '2676'
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: keep-alive
            Content-Security-Policy:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: >-
                    default-src 'self';base-uri 'self';font-src 'self' https:
                    data:;form-action 'self';frame-ancestors 'self';img-src
                    'self' data:;object-src 'none';script-src
                    'self';script-src-attr 'none';style-src 'self' https:
                    'unsafe-inline';upgrade-insecure-requests
            Cross-Origin-Opener-Policy:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: same-origin
            Cross-Origin-Resource-Policy:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: same-origin
            Origin-Agent-Cluster:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '?1'
            Referrer-Policy:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: no-referrer
            Strict-Transport-Security:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: max-age=15552000; includeSubDomains
            X-Content-Type-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: nosniff
            X-DNS-Prefetch-Control:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 'off'
            X-Download-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: noopen
            X-Frame-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: SAMEORIGIN
            X-Permitted-Cross-Domain-Policies:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: none
            X-XSS-Protection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '0'
            Vary:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Origin
            Access-Control-Allow-Credentials:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 'true'
            ETag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: W/"a74-dx2D1mMtt2pAUoC43V3YleKQ8ys"
          content:
            application/json; charset=utf-8:
              schema:
                allOf:
                  - $ref: '#/components/schemas/Success25'
                contentMediaType: application/json; charset=utf-8
              example:
                status: success
                message: Adverse Media data fetched successfully
                data:
                  id: aabbccdd-eeff-aabb-ccdd-eeffaabbccdd
                  business_id: aabbccdd-eeff-aabb-ccdd-eeffaabbccdd
                  total_risk_count: 4
                  high_risk_count: 0
                  medium_risk_count: 0
                  low_risk_count: 4
                  average_risk_score: '1'
                  articles:
                    - id: aabbccdd-eeff-aabb-ccdd-eeffaabbccdd
                      title: >-
                        Genistein, a Natural Isoflavone, Alleviates
                        Seizure-Induced Respiratory Arrest in DBA/1 Mice
                      link: >-
                        https://www.frontiersin.org/journals/neurology/articles/10.3389/fneur.2021.761912/full
                      date: '2021-11-03T07:00:00.000Z'
                      source: Frontiers
                      entity_focus_score: 1
                      risk_level: LOW
                      risk_description: >-
                        The title does not contain any adverse keywords,
                        negative sentiment, or direct mention of the business
                        entity or individuals. It appears to be related to a
                        scientific study rather than an adverse media event.
                      final_score: 42.3
                      media_type: business
                      created_at: '2025-02-18T11:39:46.750Z'
                      updated_at: '2025-02-18T11:39:46.750Z'
        '403':
          description: Forbidden
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Fri, 28 Feb 2025 11:47:14 GMT
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '141'
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: keep-alive
            Content-Security-Policy:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: >-
                    default-src 'self';base-uri 'self';font-src 'self' https:
                    data:;form-action 'self';frame-ancestors 'self';img-src
                    'self' data:;object-src 'none';script-src
                    'self';script-src-attr 'none';style-src 'self' https:
                    'unsafe-inline';upgrade-insecure-requests
            Cross-Origin-Opener-Policy:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: same-origin
            Cross-Origin-Resource-Policy:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: same-origin
            Origin-Agent-Cluster:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '?1'
            Referrer-Policy:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: no-referrer
            Strict-Transport-Security:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: max-age=15552000; includeSubDomains
            X-Content-Type-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: nosniff
            X-DNS-Prefetch-Control:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 'off'
            X-Download-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: noopen
            X-Frame-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: SAMEORIGIN
            X-Permitted-Cross-Domain-Policies:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: none
            X-XSS-Protection:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: '0'
            Vary:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Origin
            Access-Control-Allow-Credentials:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: 'true'
            ETag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: W/"8d-OyL99VllE2DloZyRQezMnFz7VUc"
          content:
            application/json; charset=utf-8:
              schema:
                allOf:
                  - $ref: '#/components/schemas/Error1'
                  - examples:
                      - status: fail
                        message: You are not allowed to access the data.
                        errorCode: UNAUTHORIZED
                        data:
                          errorName: AccessMiddlewareError
                contentMediaType: application/json; charset=utf-8
              example:
                status: fail
                message: You are not allowed to access the data.
                errorCode: UNAUTHORIZED
                data:
                  errorName: AccessMiddlewareError
      deprecated: false
      security:
        - bearer: []
      servers:
        - url: https://api.joinworth.com/integration/api/v1
          variables: {}
components:
  schemas:
    Success25:
      title: Success25
      type: object
      description: Successful response wrapper for adverse media retrieval operations.
      properties:
        status:
          type: string
          description: >-
            Outcome flag for the request; typically "success" when data is
            returned.
        message:
          type: string
          description: >-
            Human-readable confirmation that the adverse media payload was
            generated successfully.
        data:
          description: Business-level adverse media summary and associated article list.
          allOf:
            - $ref: '#/components/schemas/Data106'
    Error1:
      title: Error1
      required:
        - status
        - message
        - errorCode
        - data
      type: object
      description: >-
        Standard error envelope for failed API responses, including a stable
        error code and detail payload.
      properties:
        status:
          type: string
          description: >-
            Outcome flag for the request; typically "fail" when this object is
            returned.
        message:
          type: string
          description: End-user or integrator-facing summary of what went wrong.
        errorCode:
          type: string
          description: >-
            Stable application error code (for example UNAUTHORIZED) for
            programmatic handling.
        data:
          description: >-
            Additional structured error context, such as the specific middleware
            or domain error name.
          allOf:
            - $ref: '#/components/schemas/Data1'
      examples:
        - status: fail
          message: You are not allowed to access the data.
          errorCode: UNAUTHORIZED
          data:
            errorName: AccessMiddlewareError
    Data106:
      title: Data106
      type: object
      description: >-
        Aggregated adverse media screening outcome for a single business,
        including counts and referenced articles.
      properties:
        id:
          type: string
          description: Identifier of this adverse media aggregate record.
        business_id:
          type: string
          description: Business UUID this screening result belongs to.
        total_risk_count:
          type: integer
          contentEncoding: int32
          description: >-
            Total number of articles or hits included in this adverse media
            assessment.
        high_risk_count:
          type: integer
          contentEncoding: int32
          description: Count of articles classified under the highest risk tier.
        medium_risk_count:
          type: integer
          contentEncoding: int32
          description: Count of articles classified under medium risk.
        low_risk_count:
          type: integer
          contentEncoding: int32
          description: Count of articles classified under low or informational risk.
        average_risk_score:
          type: string
          description: >-
            String representation of the mean risk score across matched
            articles, for display or downstream rules.
        articles:
          type: array
          items:
            $ref: '#/components/schemas/Article'
          description: >-
            List of individual articles contributing to this business’s adverse
            media picture.
    Data1:
      title: Data1
      required:
        - errorName
      type: object
      description: >-
        Structured error detail returned when an operation fails authorization
        or business rules.
      properties:
        errorName:
          type: string
          description: >-
            Machine-readable error class name identifying which subsystem or
            middleware produced the failure.
      examples:
        - errorName: BankingApiError
    Article:
      title: Article
      type: object
      description: >-
        A single news or public record item that matched adverse-media criteria
        for the business.
      properties:
        id:
          type: string
          description: >-
            Unique identifier of this article record within the adverse media
            dataset.
        title:
          type: string
          description: Headline or title of the source article as published.
        link:
          type: string
          description: >-
            Canonical URL to the original published content for review and
            audit.
        date:
          type: string
          description: >-
            Publication or event date associated with the article, typically in
            ISO 8601 format.
        source:
          type: string
          description: Name of the publisher or outlet that produced the content.
        entity_focus_score:
          type: integer
          contentEncoding: int32
          description: >-
            Numeric score indicating how strongly the content focuses on the
            subject entity (scale defined by the screening provider).
        risk_level:
          type: string
          description: >-
            Categorized risk tier for this article (for example LOW, MEDIUM, or
            HIGH) for compliance triage.
        risk_description:
          type: string
          description: >-
            Human-readable rationale summarizing why the article received its
            risk classification.
        final_score:
          type: number
          description: >-
            Numeric risk score computed for this specific article, used for
            ranking and aggregate statistics.
        media_type:
          type: string
          description: >-
            Classification of the source or channel for this hit (for example
            business news, litigation, or general press).
        created_at:
          type: string
          description: >-
            Timestamp when this article was first ingested or associated with
            the adverse media result set.
        updated_at:
          type: string
          description: >-
            Timestamp of the last update to this article’s metadata or risk
            assessment.
      examples: []
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: >-
        JWT or access token issued by the identity provider; required to
        authorize adverse media requests.

````