---
title: "Verify auth data"
method: POST
path: "/auth/verify"
tags: ["plaid"]
---

# Verify auth data

`POST /auth/verify`

The `/auth/verify` endpoint verifies bank account and routing numbers and (optionally) account owner names against Plaid's database via [Database Auth](https://plaid.com/docs/auth/coverage/database-auth/). It can be used to verify account numbers that were not collected via the Plaid Link flow.

This endpoint is currently in Early Availability; contact sales or your Plaid account manager to request access.

## Request body

- AuthVerifyRequest — AuthVerifyRequest defines the request schema for `/auth/verify`
  - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
  - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.
  - `legal_name` string, nullable — Account owner's legal name
  - `numbers` AuthVerifyRequestNumbers, required — An object containing identifying account numbers for verification via Database Auth
    - `ach` AuthVerifyNumbersACH, required — ACH numbers for verification via Database Auth
      - `account` string, required — Account's account number
      - `routing` string, required — Account's routing number

## Response `200`

success

- AuthVerifyResponse — AuthVerifyResponse defines the response schema for `/auth/verify`
  - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.
  - `item_id` string, nullable — The `item_id` value of the Item created for verification. If numbers data provided is invalid, an Item may not be created.
  - `verification_status` string, required — Indicates the Item's database verification status. Possible values are: `database_insights_fail`: The Item's numbers have been verified using Plaid's data sources and have signal for being invalid and/or have no signal for being valid. Typically this indicates that the routing number is invalid, the account number does not match the account number format associated with the routing number, or the account has been reported as closed or frozen. Only returned for Auth Items created via Database Auth. `database_insights_pass`: The Item's numbers have been verified using Plaid's data sources: the routing and account number match a routing and account number of an account recognized on the Plaid network, and the account is not known by Plaid to be frozen or closed. Only returned for Auth Items created via Database Auth. `database_insights_pass_with_caution`: The Item's numbers have been verified using Plaid's data sources and have some signal for being valid: the routing and account number were not recognized on the Plaid network, but the routing number is valid and the account number is a potential valid account number for that routing number. Only returned for Auth Items created via Database Auth.
  - `verification_insights` AccountVerificationInsights, required — Insights from performing database verification for the account. Only returned for Auth Items using Database Auth.
    - `name_match_score` integer, nullable — Indicates the score of the name match between the given name provided during database verification (available in the [`verification_name`](https://plaid.com/docs/api/products/auth/#auth-get-response-accounts-verification-name) field if using standard Database Auth, or provided in the request if using `/auth/verify`) and matched Plaid network accounts. If defined, will be a value between 0 and 100. Will be undefined if name matching was not enabled for the database verification session or if there were no eligible Plaid network matches to compare the given name with.
    - `network_status` AccountVerificationInsightsNetworkStatus, required — Status information about the account and routing number in the Plaid network.
      - `has_numbers_match` boolean, required — Indicates whether we found at least one matching account for the ACH account and routing number.
      - `is_numbers_match_verified` boolean, required — Indicates if at least one matching account for the ACH account and routing number is already verified.
    - `previous_returns` AccountVerificationInsightsPreviousReturns — Information about known ACH returns for the account and routing number.
      - `has_previous_administrative_return` boolean, required — Indicates whether Plaid's data sources include a known administrative ACH return for this account and routing number.
    - `account_number_format` 'valid' | 'invalid' | 'unknown', required — Indicator of account number format validity for institution. `valid`: indicates that the account number has a correct format for the institution. `invalid`: indicates that the account number has an incorrect format for the institution. `unknown`: indicates that there was not enough information to determine whether the format is correct for the institution.

## Other responses

- `default` — Default error

---

[API](https://skmtc.net/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.net/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/versions/64c4514ea59b/schema)