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

# Get Match Pro Result

> Retrieves the latest Match Pro result for a business. The response shape depends on the current state:

- **Result available**: Returns the full match data object.
- **Processing**: The check is still running. Retry after a short delay (results typically appear within 1–5 minutes).
- **Not yet run**: No Match Pro check has been initiated for this business.

The `businessId` path parameter must belong to the caller's tenant. Cross-tenant access is rejected with `403`.



## OpenAPI

````yaml openapi/integration-service/match-pro.json get /verification/businesses/{businessId}/match-pro
openapi: 3.1.0
info:
  title: Integration Service
  description: >-
    Match Pro endpoints for running payment network match checks against
    businesses.
  version: '1.0'
servers:
  - url: https://api.joinworth.com/integration/api/v1
    variables: {}
security:
  - bearer: []
paths:
  /verification/businesses/{businessId}/match-pro:
    get:
      tags:
        - Match Pro
      summary: Get Match Pro Result
      description: >-
        Retrieves the latest Match Pro result for a business. The response shape
        depends on the current state:


        - **Result available**: Returns the full match data object.

        - **Processing**: The check is still running. Retry after a short delay
        (results typically appear within 1–5 minutes).

        - **Not yet run**: No Match Pro check has been initiated for this
        business.


        The `businessId` path parameter must belong to the caller's tenant.
        Cross-tenant access is rejected with `403`.
      operationId: GetMatchProResult
      parameters:
        - name: businessId
          in: path
          description: UUID of the business whose Match Pro result to retrieve.
          required: true
          schema:
            type: string
            examples:
              - b9c8d7e6-f5a4-3210-fedc-ba9876543210
      responses:
        '200':
          description: >-
            Match Pro result retrieved. See response examples for the three
            possible states.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MatchProResultResponse'
              examples:
                result_available:
                  summary: Match result available
                  value:
                    status: success
                    message: Match Pro result retrieved successfully
                    data:
                      matchData:
                        businessId: b9c8d7e6-f5a4-3210-fedc-ba9876543210
                        matchResult: No Match
                processing:
                  summary: Check still in progress
                  value:
                    status: success
                    message: Match Pro processing.
                    data:
                      matchState: processing
                      processingMessage: >-
                        Match Pro is verifying this business. Results typically
                        appear within 1-5 minutes — no action needed.
                not_yet_run:
                  summary: No check has been run for this business
                  value:
                    status: success
                    data:
                      errors:
                        error:
                          - source: DB
                            details: This business has not been reviewed in Match Pro
        '401':
          description: Missing or invalid Bearer token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: >-
            Cross-tenant access denied. The `businessId` does not belong to the
            caller's tenant.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearer: []
components:
  schemas:
    MatchProResultResponse:
      title: MatchProResultResponse
      type: object
      description: >-
        Response from the Match Pro result endpoint. The shape varies based on
        the current state of the check: result available, still processing, or
        not yet run.
      properties:
        status:
          type: string
          enum:
            - success
        message:
          type: string
          description: Descriptive message about the current state.
        data:
          type: object
          description: >-
            Match result data, a processing indicator, or an error structure
            depending on state.
          properties:
            matchData:
              type: object
              description: >-
                Present when a result is available. Contains the match outcome
                for the business.
              properties:
                businessId:
                  type: string
                  description: UUID of the business this result belongs to.
                matchResult:
                  type: string
                  description: The match outcome (e.g. `No Match` or a match indicator).
                  examples:
                    - No Match
              additionalProperties: true
            matchState:
              type: string
              enum:
                - processing
              description: Present only when the check is still running.
            processingMessage:
              type: string
              description: Human-readable message shown while the check is processing.
            errors:
              type: object
              description: >-
                Present when no check has been run. Contains a `not yet run`
                indicator.
              properties:
                error:
                  type: array
                  items:
                    type: object
                    properties:
                      source:
                        type: string
                      details:
                        type: string
    ErrorResponse:
      title: ErrorResponse
      type: object
      properties:
        status:
          type: string
          enum:
            - error
            - fail
        message:
          type: string
          description: Description of the error.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````