> ## Documentation Index > Fetch the complete documentation index at: https://docs.baselayer.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a direct verification > Returns a verification: its state, verdicts, `terminal_reason`, and the pairwise references it issued. This is direct verification: you send an identity you collected. For a hosted enrollment session, where the applicant completes your published journey on Baselayer's page, use `POST /onboarding/sessions`. ## OpenAPI ````yaml /api-reference/openapi.json get /issuance/identities/verifications/{verification_id} openapi: 3.1.0 info: title: baselayer-api-service version: 0.1.0 servers: - url: https://api.baselayer.com/ security: [] paths: /issuance/identities/verifications/{verification_id}: get: tags: - Identities summary: Get a direct verification description: >- Returns a verification: its state, verdicts, `terminal_reason`, and the pairwise references it issued. This is direct verification: you send an identity you collected. For a hosted enrollment session, where the applicant completes your published journey on Baselayer's page, use `POST /onboarding/sessions`. operationId: issuance_identities_verifications_get parameters: - name: verification_id in: path required: true schema: type: string format: uuid title: Verification Id responses: '200': description: Response content: application/json: schema: $ref: '#/components/schemas/v1.Verification' application/vnd.baselayer.v1+json: schema: $ref: '#/components/schemas/v1.Verification' '404': description: The verification id is unknown to your application. content: application/json: schema: $ref: '#/components/schemas/Error' title: ResourceNotFound description: Could not locate the resource for the given URI. examples: - type: resource_not_found code: 1 message: Could not locate the resource for the given URI. metadata: {} '422': description: The request is invalid. content: application/json: schema: $ref: '#/components/schemas/Error' title: ValidationFailed description: The request is invalid. examples: - type: validation_failed code: 7112 message: The request is invalid. metadata: {} security: - APIKeyHeader: [] components: schemas: v1.Verification: description: >- A verification of an individual, or of an individual and the business they operate, submitted directly. The body of every ``/issuance/identities/verifications`` route and of the ``Verification.*`` webhooks. properties: verification_id: description: Unique id of the verification. format: uuid title: Verification Id type: string type: $ref: '#/components/schemas/v1.VerificationType' description: Whether a business is verified too. state: $ref: '#/components/schemas/v1.VerificationState' description: Lifecycle state of the verification workflow. automated_verdict: anyOf: - $ref: '#/components/schemas/v1.OnboardingVerdict' - type: 'null' default: null description: >- What the checks concluded, `APPROVED` or `UNDER_REVIEW`; null until the verification completes. verdict: anyOf: - $ref: '#/components/schemas/v1.OnboardingVerdict' - type: 'null' default: null description: >- The effective verdict: your reviewer's decision when one was made, otherwise `automated_verdict`. terminal_reason: anyOf: - $ref: '#/components/schemas/v1.IdentitySubmissionTerminalReasonResponse' - type: 'null' default: null description: >- Typed state and detail when the workflow ended in FAILED; null otherwise. individual_ref: anyOf: - type: string - type: 'null' default: null description: >- Your pairwise reference to the verified individual, stable across re-verification; set once the verification completes and is approved. title: Individual Ref business_ref: anyOf: - type: string - type: 'null' default: null description: >- Your pairwise reference to the verified business, when the verification covered one. title: Business Ref business_operator_link_status: anyOf: - $ref: '#/components/schemas/v1.BusinessOperatorLinkStatus' - type: 'null' default: null description: >- Status of the individual-operates-business link as of this verification. reference_id: anyOf: - type: string - type: 'null' default: null description: Caller-supplied correlation id. title: Reference Id idempotency_key: anyOf: - type: string - type: 'null' default: null description: The `Idempotency-Key` the verification was created with. title: Idempotency Key environment: $ref: '#/components/schemas/v1.ApplicationType' description: The environment the verification ran in. created_at: description: When the verification was created. format: date-time title: Created At type: string completed_at: anyOf: - format: date-time type: string - type: 'null' default: null description: When the verification reached a terminal status. title: Completed At required: - verification_id - type - state - environment - created_at title: Verification (v1) type: object Error: properties: type: type: string title: Type description: >- Stable snake_case name of the error. Branch on this, never on `message`. code: type: integer title: Code description: Integer catalog code of the error. message: type: string title: Message description: For a human reading a log; not stable and not localized. metadata: additionalProperties: true type: object title: Metadata description: Context documented per `type`. request_id: anyOf: - type: string - type: 'null' title: Request Id description: The `X-Request-ID` of the failed request. type: object required: - type - code - message title: Error description: The one body of every error a KYA route answers. v1.VerificationType: description: |- What a verification verifies: an ``INDIVIDUAL`` alone, or an individual together with the ``BUSINESS`` they operate. enum: - INDIVIDUAL - BUSINESS title: VerificationType type: string v1.VerificationState: description: |- A verification's lifecycle as a customer reads it: the workflow's states, with an internal stop reported as ``FAILED``. enum: - PENDING - EXECUTING - WAITING - COMPLETED - FAILED - EXPIRED title: VerificationState type: string v1.OnboardingVerdict: description: Normalized onboarding verdict used across provider-specific outputs. enum: - APPROVED - UNDER_REVIEW - REJECTED title: OnboardingVerdict type: string v1.IdentitySubmissionTerminalReasonResponse: description: Typed explanation for a submission that did not complete. properties: state: $ref: '#/components/schemas/v1.TerminalReasonState' description: Terminal workflow state. message: anyOf: - type: string - type: 'null' default: null description: Human-readable detail recorded by the workflow. title: Message required: - state title: IdentitySubmissionTerminalReasonResponse (v1) type: object v1.BusinessOperatorLinkStatus: description: |- Your organization's status for the link between an individual and a business they operate. VERIFIED is earned by the full evidence recipe (TIN provided + IRS-matched + KYB-verified) on one of your own sessions, or decided by your organization; UNDER_REVIEW is every automatic shortfall; REJECTED is your organization's refusal, which stands until you decide again. Another organization's evidence or decision never changes it. enum: - VERIFIED - UNDER_REVIEW - REJECTED title: BusinessOperatorLinkStatus type: string v1.ApplicationType: enum: - sandbox - production title: ApplicationType type: string v1.TerminalReasonState: description: |- The terminal state a ``terminal_reason`` explains: only a failure carries one. enum: - FAILED title: TerminalReasonState type: string securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.