> This page is for version 2025-10-27. > For other versions, use one of these documentation indexes: > - 2026-09-29 (default): https://docs.withpersona.com/2026-09-29/llms.txt > - 2025-12-08: https://docs.withpersona.com/2025-12-08/llms.txt > - 2025-10-27: https://docs.withpersona.com/2025-10-27/llms.txt > - 2023-01-05: https://docs.withpersona.com/2023-01-05/llms.txt > - 2022-09-01: https://docs.withpersona.com/2022-09-01/llms.txt > - 2021-07-05: https://docs.withpersona.com/2021-07-05/llms.txt > - 2021-05-14: https://docs.withpersona.com/2021-05-14/llms.txt > - 2020-05-18: https://docs.withpersona.com/2020-05-18/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.withpersona.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.withpersona.com/_mcp/server. # Create a Database Business Verification POST https://api.withpersona.com/api/v1/verification/database-businesses Content-Type: application/json Create a new database business verification Reference: https://docs.withpersona.com/api-reference/verifications/database-business-verifications/create-a-database-business-verification ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Query parameters - `include` (string, optional) — A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the `included` key in the response. See [Serialization](https://docs.withpersona.com/serialization#inclusion-of-related-resources) for more details. - `fields` (map from string to string, optional) — Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See [Serialization](https://docs.withpersona.com/serialization#sparse-fieldsets) for more details. ### Headers - `Key-Inflection` (enum, optional) — Determines casing for the API response. - Allowed values: `camel`, `kebab`, `snake` - `Idempotency-Key` (string, optional) — Ensures the request is idempotent. - `Persona-Version` (enum, optional) — Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning). - Allowed values: `2026-09-29`, `2025-12-08`, `2025-10-27`, `2023-01-05`, `2022-09-01`, `2021-08-18`, `2021-07-05`, `2021-02-21`, `2020-05-18` ### Body (application/json) This endpoint expects an object. - `data` (VerificationDatabaseBusinessesPostRequestBodyContentApplicationJsonSchemaData, required) - `meta` (VerificationDatabaseBusinessesPostRequestBodyContentApplicationJsonSchemaMeta, optional) ## Response ### 201 This endpoint returns a Database Business Verification object and (optionally) its related objects in `included`. - `data` (Database Business Verification, required) — A Database Business Verification ## Errors ### 400 Bad Request Error The request was unacceptable, often due to invalid parameters. - `errors` (list of VerificationDatabaseBusinessesPostResponsesContentApplicationJsonSchemaErrorsItems, optional) ### 401 Unauthorized Error An invalid API key was provided. - `errors` (list of VerificationDatabaseBusinessesPostResponsesContentApplicationJsonSchemaErrorsItems, optional) ### 403 Forbidden Error The given API key doesn’t have permissions to perform the request or a quota has been exceeded. - `errors` (list of VerificationDatabaseBusinessesPostResponsesContentApplicationJsonSchemaErrorsItems, optional) ### 404 Not Found Error The requested resource doesn’t exist. - `errors` (list of VerificationDatabaseBusinessesPostResponsesContentApplicationJsonSchemaErrorsItems, optional) ### 409 Conflict Error The request conflicts with another request, often due to attempting to create a duplicate resource. - `errors` (list of VerificationDatabaseBusinessesPostResponsesContentApplicationJsonSchemaErrorsItems, optional) ### 422 Unprocessable Entity Error The request modifies the resource in an unacceptable way, often due to an invalid action or parameter. - `errors` (list of VerificationDatabaseBusinessesPostResponsesContentApplicationJsonSchemaErrorsItems, optional) ### 429 Too Many Requests Error Your organization’s rate limit has been exceeded. We recommend an exponential backoff on requests. - `errors` (list of VerificationDatabaseBusinessesPostResponsesContentApplicationJsonSchemaErrorsItems, optional) ## Types ### VerificationDatabaseBusinessesPostRequestBodyContentApplicationJsonSchemaData - `attributes` (VerificationDatabaseBusinessesPostRequestBodyContentApplicationJsonSchemaDataAttributes, required) ### VerificationDatabaseBusinessesPostRequestBodyContentApplicationJsonSchemaMeta - `debug-forced-status` (string, optional) - `processing-mode` (string, optional) ### Database Business Verification A Database Business Verification - `id` (string, optional) — The token of the verification - `attributes` (VerificationDiscriminatorMappingVerificationDatabaseBusinessAttributes, optional) - `relationships` (verification-shared-relationships, optional) ### VerificationDatabaseBusinessesPostResponsesContentApplicationJsonSchemaErrorsItems - `title` (string, optional) - `details` (string, optional) ### VerificationDatabaseBusinessesPostRequestBodyContentApplicationJsonSchemaDataAttributes - `business-name` (string, required) — Name of the business - `address-country-code` (string, required) — Country code of the business address. - `verification-template-id` (string, required) — ID of Verification Template. You can find your Verification Template IDs [here](https://app.withpersona.com/dashboard/verification-templates?filter=%7B%22type%22%3A%5B%22verification-template%2Fdatabase-business"%5D%7D) - `registration-number` (string, optional, nullable) — Registration number of the business - `address-street-1` (string, optional, nullable) — Street name of business address. - `address-street-2` (string, optional, nullable) — Extension of business address, usually apartment or suite number. - `address-city` (string, optional, nullable) — City of business address. Not all international addresses use this attribute. - `address-subdivision` (string, optional, nullable) — State or subdivision of business address. In the US, this should be the abbreviated name. Not all international addresses use this attribute. - `address-postal-code` (string, optional, nullable) — ZIP or postal code of residence address. Not all international addresses use this attribute. ### VerificationDiscriminatorMappingVerificationDatabaseBusinessAttributes - `address-city` (string, optional, nullable) — City of business address. Not all international addresses use this attribute. - `address-country-code` (string, optional) — Country code of the business address. - `address-postal-code` (string, optional, nullable) — ZIP or postal code of residence address. Not all international addresses use this attribute. - `address-street-1` (string, optional, nullable) — Street name of business address. - `address-street-2` (string, optional, nullable) — Extension of business address, usually apartment or suite number. - `address-subdivision` (string, optional, nullable) — State or subdivision of business address. In the US, this should be the abbreviated name. Not all international addresses use this attribute. - `birthdate` (date, optional, nullable) — Birthdate, must be in the format "YYYY-MM-DD". - `business-name` (string, optional) — Name of the business - `checks` (list of VerificationSharedAttributesChecksItems, optional) - `completed-at` (datetime, optional, nullable) — The time the verification was completed in ISO 8601 format - `completed-at-ts` (integer, optional, nullable) — The time the verification was completed in Unix timestamp format - `country-code` (string, optional, nullable) — ISO 3166-1 alpha 2 country code. - `created-at` (datetime, optional) — The time the verification was created in ISO 8601 format - `created-at-ts` (integer, optional) — The time the verification was created in Unix timestamp format - `email-address` (string, optional, nullable) — Email address. - `name-first` (string, optional, nullable) — Given or first name. - `name-last` (string, optional, nullable) — Family or last name. - `name-middle` (string, optional, nullable) — Middle name. - `phone-number` (string, optional, nullable) — Phone number. - `redacted-at` (datetime, optional, nullable) — The time the verification was redacted in ISO 8601 format - `registration-number` (string, optional, nullable) — Registration number of the business - `status` (string, optional) — The status of the verification Possible values: - initiated - submitted - tentatively_passed (only for `verification/document` and `verification/qes-infocert`) - tentatively_failed (only for `verification/database-business` and `verification/database-business-footprint`) - passed - failed - requires_retry - skipped - canceled - confirmed (only for `verification/email-address` and `verification/phone-number`) Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `submitted-at` (datetime, optional, nullable) — The time the verification was submitted in ISO 8601 format - `submitted-at-ts` (integer, optional, nullable) — The time the verification was submitted in Unix timestamp format - `tags` (list of string, optional) — Tags on the verification ### verification-shared-relationships - `inquiry` (VerificationSharedRelationshipsInquiry, optional) — The inquiry linked to the verification - `template` (VerificationSharedRelationshipsTemplate, optional) - `inquiry-template-version` (VerificationSharedRelationshipsInquiryTemplateVersion, optional) - `inquiry-template` (VerificationSharedRelationshipsInquiryTemplate, optional) - `transaction` (VerificationSharedRelationshipsTransaction, optional) - `verification-template` (VerificationSharedRelationshipsVerificationTemplate, optional) - `verification-template-version` (VerificationSharedRelationshipsVerificationTemplateVersion, optional) - `accounts` (VerificationSharedRelationshipsAccounts, optional) ### VerificationSharedAttributesChecksItems - `name` (string, optional) - `status` (string, optional) — Possible values: - passed - failed - not_applicable Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `category` (string, optional, nullable) — The category assigned to the check. Possible values include: - biometrics - fraud - user_action_required - validity This categorizes the check itself, not its outcome. A null category means the check is uncategorized or its category is unknown; it must not be interpreted as non-fraud. Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `reasons` (list of string, optional) — If applicable, reasons are the list of reasons explaining why the check failed or is not applicable. For some checks, `reasons` is the primary signal carrying the underlying detection results. For example, `business_website_malicious_website_detection` surfaces its IPQS and Google Web Risk signals here (e.g. `malware`, `phishing`, `spam-source`) rather than in `metadata`. - `requirement` (string, optional) — Possible values: - required - not_required - requires_retry Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `metadata` (map from string to any, optional) — This is a free-form object containing relevant metadata to the processing and result of the check. ### VerificationSharedRelationshipsInquiry The inquiry linked to the verification - `data` (VerificationSharedRelationshipsInquiryData, optional, nullable) ### VerificationSharedRelationshipsTemplate - `data` (VerificationSharedRelationshipsTemplateData, optional, nullable) ### VerificationSharedRelationshipsInquiryTemplateVersion - `data` (VerificationSharedRelationshipsInquiryTemplateVersionData, optional, nullable) ### VerificationSharedRelationshipsInquiryTemplate - `data` (VerificationSharedRelationshipsInquiryTemplateData, optional, nullable) ### VerificationSharedRelationshipsTransaction - `data` (VerificationSharedRelationshipsTransactionData, optional, nullable) ### VerificationSharedRelationshipsVerificationTemplate - `data` (VerificationSharedRelationshipsVerificationTemplateData, optional, nullable) ### VerificationSharedRelationshipsVerificationTemplateVersion - `data` (VerificationSharedRelationshipsVerificationTemplateVersionData, optional, nullable) ### VerificationSharedRelationshipsAccounts - `data` (list of VerificationSharedRelationshipsAccountsDataItems, optional) ### VerificationSharedRelationshipsInquiryData - `id` (string, optional) - `type` ("inquiry", optional) ### VerificationSharedRelationshipsTemplateData - `type` ("template", optional) - `id` (string, optional) ### VerificationSharedRelationshipsInquiryTemplateVersionData - `type` ("inquiry-template-version", optional) - `id` (string, optional) ### VerificationSharedRelationshipsInquiryTemplateData - `type` ("inquiry-template", optional) - `id` (string, optional) ### VerificationSharedRelationshipsTransactionData - `type` ("transaction", optional) - `id` (string, optional) ### VerificationSharedRelationshipsVerificationTemplateData - `type` (string, optional) - `id` (string, optional) ### VerificationSharedRelationshipsVerificationTemplateVersionData - `type` (string, optional) - `id` (string, optional) ### VerificationSharedRelationshipsAccountsDataItems - `id` (string, optional) - `type` ("account", optional) ## Examples **Request** ```json { "data": { "attributes": { "business-name": "string", "address-country-code": "string", "verification-template-id": "string" } } } ``` **Response** ```json { "data": { "id": "ver_ABC123", "attributes": { "address-city": "San Francisco", "address-country-code": "US", "address-postal-code": "94103", "address-street-1": "981 Mission St", "address-street-2": "# 95", "address-subdivision": "California", "business-name": "Acme Inc", "checks": [], "completed-at": null, "completed-at-ts": null, "country-code": "US", "created-at": "2023-11-03T17:37:06.000Z", "created-at-ts": 1699033026, "registration-number": null, "status": "initiated", "submitted-at": null, "submitted-at-ts": null }, "relationships": { "inquiry": { "data": { "id": "inq_ABC123", "type": "inquiry" } }, "template": { "data": null }, "inquiry-template-version": { "data": { "type": "inquiry-template-version", "id": "itmplv_ABC123" } }, "inquiry-template": { "data": { "type": "inquiry-template", "id": "itmpl_ABC123" } }, "transaction": { "data": null }, "verification-template": { "data": { "type": "verification-template/database-business", "id": "vtmpl_ABC123" } }, "verification-template-version": { "data": { "type": "verification-template-version/database-business", "id": "vtmplv_ABC123" } } }, "type": "verification/database-business" } } ``` **SDK Code** ```python Created import requests url = "https://api.withpersona.com/api/v1/verification/database-businesses" payload = { "data": { "attributes": { "business-name": "string", "address-country-code": "string", "verification-template-id": "string" } } } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Created const url = 'https://api.withpersona.com/api/v1/verification/database-businesses'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"data":{"attributes":{"business-name":"string","address-country-code":"string","verification-template-id":"string"}}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Created package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.withpersona.com/api/v1/verification/database-businesses" payload := strings.NewReader("{\n \"data\": {\n \"attributes\": {\n \"business-name\": \"string\",\n \"address-country-code\": \"string\",\n \"verification-template-id\": \"string\"\n }\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Created require 'uri' require 'net/http' url = URI("https://api.withpersona.com/api/v1/verification/database-businesses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"data\": {\n \"attributes\": {\n \"business-name\": \"string\",\n \"address-country-code\": \"string\",\n \"verification-template-id\": \"string\"\n }\n }\n}" response = http.request(request) puts response.read_body ``` ```java Created import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.withpersona.com/api/v1/verification/database-businesses") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"data\": {\n \"attributes\": {\n \"business-name\": \"string\",\n \"address-country-code\": \"string\",\n \"verification-template-id\": \"string\"\n }\n }\n}") .asString(); ``` ```php Created request('POST', 'https://api.withpersona.com/api/v1/verification/database-businesses', [ 'body' => '{ "data": { "attributes": { "business-name": "string", "address-country-code": "string", "verification-template-id": "string" } } }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Created using RestSharp; var client = new RestClient("https://api.withpersona.com/api/v1/verification/database-businesses"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"data\": {\n \"attributes\": {\n \"business-name\": \"string\",\n \"address-country-code\": \"string\",\n \"verification-template-id\": \"string\"\n }\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Created import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["data": ["attributes": [ "business-name": "string", "address-country-code": "string", "verification-template-id": "string" ]]] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.withpersona.com/api/v1/verification/database-businesses")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```