> ## 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. # List direct verifications > Lists the verifications your application started through `POST /issuance/identities/verifications`, newest first by default. Filter by `reference_id` to find the verifications you started for one of your records. 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 openapi: 3.1.0 info: title: baselayer-api-service version: 0.1.0 servers: - url: https://api.baselayer.com/ security: [] paths: /issuance/identities/verifications: get: tags: - Identities summary: List direct verifications description: >- Lists the verifications your application started through `POST /issuance/identities/verifications`, newest first by default. Filter by `reference_id` to find the verifications you started for one of your records. 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_list parameters: - name: limit in: query required: false schema: type: integer maximum: 1000 minimum: 1 description: >- Maximum number of records to return in a single page. Must be between 1 and 1000. default: 10 title: Limit description: >- Maximum number of records to return in a single page. Must be between 1 and 1000. - name: offset in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: >- Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor. title: Offset description: >- Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor. - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset. title: Cursor description: >- Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset. - name: sort in: query required: false schema: anyOf: - $ref: '#/components/schemas/v1.VerificationSortField' - type: 'null' description: >- `created_at` (when it started) or `updated_at` (when it last changed); ties break on `created_at`, then the verification's id. Defaults to `created_at` `desc`. title: Sort description: >- `created_at` (when it started) or `updated_at` (when it last changed); ties break on `created_at`, then the verification's id. Defaults to `created_at` `desc`. - name: sort_direction in: query required: false schema: anyOf: - $ref: '#/components/schemas/SortMethod' - type: 'null' description: >- `asc` or `desc`, for every key of the sort. Defaults to the field's own: `created_at` `desc`, `updated_at` `desc`. title: Sort Direction description: >- `asc` or `desc`, for every key of the sort. Defaults to the field's own: `created_at` `desc`, `updated_at` `desc`. - name: reference_id in: query required: false schema: anyOf: - maxLength: 128 type: string - type: 'null' description: Only verifications started with this `reference_id`. title: Reference Id description: Only verifications started with this `reference_id`. - name: state in: query required: false schema: anyOf: - $ref: '#/components/schemas/v1.VerificationState' - type: 'null' description: Only verifications in this state. title: State description: Only verifications in this state. - name: type in: query required: false schema: anyOf: - $ref: '#/components/schemas/v1.VerificationType' - type: 'null' description: Only `INDIVIDUAL` or only `BUSINESS` verifications. title: Type description: Only `INDIVIDUAL` or only `BUSINESS` verifications. responses: '200': description: Paginated verifications in the requested order. content: application/json: schema: type: array items: $ref: '#/components/schemas/v1.Verification' application/vnd.baselayer.v1+json: schema: type: array items: $ref: '#/components/schemas/v1.Verification' headers: X-Total-Count: description: Total number of records matching the query. schema: type: integer X-Total-Pages: description: Total number of pages available based on the current limit. schema: type: integer X-Next-Cursor: description: >- Cursor for the next page (only present when using the keyset pagination and if `has_more` is true. schema: type: string '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.VerificationSortField: type: string enum: - created_at - updated_at title: VerificationSortField description: What the verifications list sorts by. SortMethod: type: string enum: - asc - desc title: SortMethod 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.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.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.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.