Verify a business

post

https://sandbox-api.coris.ai/api/v0_2/business/verification/

Starts a KYB check of a legal name and address against Secretary of State records, with optional TIN verification and OFAC/AML screening. Use it to confirm details the applicant gave you. To collect a wider profile, use Create a Merchant Profiler request.

Lifecycle: POST returns 201 and a request_id. Poll Get business verification results: 425 means no data yet, 206 means partial data, and 200 means complete. If you send callback_url, Coris posts the result when it is done, as Handle async requests explains.

sequenceDiagram
  accTitle: Verify a business sequence diagram
  accDescr: Verify a business. You send POST /business/verification/. Coris replies 201 request_id. You send GET ?request_id=... Coris replies 425 no data yet, or 206 partial data. You send GET ?request_id=... Coris replies 200 complete. Coris sends POST callback_url, if sent.
  participant You
  participant Coris
  You->>Coris: POST /business/verification/
  Coris-->>You: 201 request_id
  You->>Coris: GET ?request_id=...
  Coris-->>You: 425 no data yet, or 206 partial data
  You->>Coris: GET ?request_id=...
  Coris-->>You: 200 complete
  Coris->>You: POST callback_url, if sent

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Information for business verification

verification_types

array of strings

Extra checks to run on top of the Secretary of State match, which always runs. An unknown value returns 400.

TIN_VERIFICATION: check the ein against IRS records. Requires ein.
OFAC_AML_SCREENING: screen the business against sanctions and AML lists.

verification_types

Allowed:

legal_name

string

The legal name of the business. Required unless search_result_id supplies it.

address

object

The primary address of the business, with country and either a postal code or city and state. Required unless search_result_id supplies it.

ein

string

The business Tax Identification Number, required for TIN_VERIFICATION. Never send a Social Security Number.

search_result_id

string

A search_result_id from Get business search results. Coris fills legal_name, address and ein from that search when you omit them, and an unknown ID returns 400.

callback_url

uri

A public HTTPS URL where Coris posts the result, if you want to skip polling.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Callback

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/html

201The job started. Use request_id to get the result.

400legal_name, the address or an EIN for TIN_VERIFICATION is missing, a verification type or search_result_id is invalid, or callback_url is invalid. The body is a plain-text message.

401The key is missing, or it is wrong for this host. Send Authorization: Token YOUR_API_KEY with a key issued for this environment.

403A scoped key cannot use this route, and gets JSON with detail. Use a key without account limits.

429You passed a rate limit. If Retry-After is present, wait that many seconds, then retry. If it is absent, you hit the concurrency limit, so back off for a few seconds and reduce parallel calls.

500Coris could not complete the request. Retry with backoff. If it continues, contact support.