> ## 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 Open Journey Service (Upcoming)

> Document Verification Open Journey Service API Documentation

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

## Endpoint

**POST** `/openJourney`


## OpenAPI

````yaml POST /openJourney
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:
  /openJourney:
    post:
      summary: Open Journey
      description: >-
        Starts a new verification journey where the customer can submit
        documents in steps.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                passThroughData:
                  type: object
                  description: Optional metadata to be carried through the journey.
      responses:
        '200':
          description: Successfully opened verification journey.
          content:
            application/json:
              schema:
                type: object
                properties:
                  journeyId:
                    type: string
                    description: Unique identifier for the verification journey.
                    example: uniqueJourneyIdentifier
                  passThroughData:
                    type: object
                    description: Optional metadata to be carried through the journey.
        '400':
          description: Bad request due to missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '401':
          description: API key is missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error401'
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
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Bearer token obtained from POST /auth. Valid for 60 minutes.

````