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

# Document Verification Verify Service (Upcoming)

> Document Verification Verify Service API Documentation

For a usage description of the Document Verification Verify Service, please refer to the [Document Verification](/essentials/documentVerification) page.

## Endpoint

**POST** `/verify`


## OpenAPI

````yaml POST /verify
openapi: 3.1.0
info:
  title: Umbrella API
  version: 1.0.0
  description: >-
    API documentation for Umbrella services including KYB, KYC, AML, payments,
    phone intelligence, onboarding, and address verification.
servers:
  - url: https://api-umbrella.io/api/services
    description: Production
  - url: https://sandbox-umbrella-api.azurewebsites.net/api/services
    description: Sandbox
security:
  - bearerAuth: []
paths:
  /verify:
    post:
      summary: Verify Documents
      description: >-
        Initiates the verification of all images submitted in this journey.
        Returns a detailed verification result.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - journeyId
              properties:
                journeyId:
                  type: string
                  description: Unique identifier for the verification journey.
                  example: uniqueJourneyIdentifier
      responses:
        '200':
          description: Successfully verified documents.
          content:
            application/json:
              schema:
                type: object
                properties:
                  journeyId:
                    type: string
                    description: Unique identifier for the verification journey.
                  status:
                    type: string
                    description: Status of the verification process.
                    example: verificationComplete
                  identitySubject:
                    type: object
                    properties:
                      type:
                        type: string
                        description: Type of identity subject.
                        example: person
                      fullName:
                        type: string
                        description: Full name as extracted from the document.
                        example: Max Mustermann
                      nameStructure:
                        type: object
                        properties:
                          firstName:
                            type: string
                            description: First name of the individual.
                            example: Max
                          lastName:
                            type: string
                            description: Last name of the individual.
                            example: Mustermann
                          nativeFullName:
                            type: string
                            description: Native full name of the individual.
                            example: Max Mustermann
                      gender:
                        type: string
                        description: Gender (M, F, or X).
                        enum:
                          - M
                          - F
                          - X
                        example: M
                      nationality:
                        type: string
                        description: Nationality code (ISO 3166).
                        example: DE
                      dob:
                        type: string
                        description: Date of birth (YYYY/MM/DD).
                        example: 1990/01/01
                      addressSingleLine:
                        type: string
                        description: Extracted address in single-line format.
                        example: 123 Main St, City, Country
                      email:
                        type: string
                        description: Extracted email (if available).
                        example: max.mustermann@example.com
                      mobileNumber:
                        type: string
                        description: Extracted mobile number (if available).
                        example: '+1234567890'
                  authoritativeData:
                    type: object
                    properties:
                      identityDocument:
                        type: object
                        properties:
                          type:
                            type: string
                            description: Type of document.
                            example: passport
                          idNumber:
                            type: string
                            description: Document ID number.
                            example: '123456789'
                          issuingCountry:
                            type: string
                            description: Country that issued the document.
                            example: DE
                          expeditor:
                            type: string
                            description: Issuing authority.
                            example: BH Neunkirchen
                          expirationDate:
                            type: string
                            description: Expiry date of the document (YYYY/MM/DD).
                            example: 2030/01/01
                          verificationChannel:
                            type: string
                            description: How verification was performed.
                            example: optical
                  proofOfWork:
                    type: object
                    properties:
                      type:
                        type: string
                        description: Type of proof.
                        example: image
                      titleOfProof:
                        type: string
                        description: Title describing the proof.
                        example: IDFront
                      timestampOfProof:
                        type: string
                        description: Timestamp when the proof was collected.
                        example: 2024/08/01T10:00:00Z
                  auditTrail:
                    type: object
                    properties:
                      workId:
                        type: string
                        description: Unique ID of the verification attempt.
                        example: abc123
                      workStatus:
                        type: string
                        description: Status of the work.
                        enum:
                          - PASS
                          - FAIL
                        example: PASS
                      workStartTst:
                        type: string
                        description: Timestamp when the verification started.
                        example: 2024/08/01T10:00:00Z
                      workEndTst:
                        type: string
                        description: Timestamp when the verification ended.
                        example: 2024/08/01T10:01:00Z
                      workResult:
                        type: string
                        description: Summary of the verification result.
                        example: Verification successful
                  fraudAlerts:
                    type: object
                    properties:
                      fraudAlertDetail:
                        type: array
                        description: List of detected fraud alerts (if any).
                        items:
                          type: object
                      aggregateFraudAlertScore:
                        type: number
                        description: Overall fraud risk score (0 = no risk).
                        example: 0
                  croppedImages:
                    type: object
                    properties:
                      front:
                        type: string
                        description: Base64-encoded image of the front side.
                      portrait:
                        type: string
                        description: Base64-encoded portrait image from the document.
                      signature:
                        type: string
                        description: Base64-encoded signature image.
                      back:
                        type: string
                        description: Base64-encoded image of the back side.
                      selfie:
                        type: string
                        description: Base64-encoded selfie image (if applicable).
        '400':
          description: Invalid request payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '401':
          description: Unauthorized request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error401'
        '404':
          description: Journey not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
components:
  schemas:
    Error400:
      required:
        - message
      type: object
      properties:
        message:
          type: string
          example: Invalid request payload
    Error401:
      required:
        - message
      type: object
      properties:
        message:
          type: string
          example: Unauthorized request
    Error404:
      type: object
      properties:
        message:
          type: string
          example: Journey not found
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Bearer token obtained from POST /auth. Valid for 60 minutes.

````