- Docs
- API reference
- Endpoints and schemas
- KYB API
- Checks
Registration and person checks
How the domestic registration and person verification tasks check the registrations of the matched registered entity, and the results each one returns.
The registration and person checks read the registrations of the registered
entity Enigma matched. domestic_registration reports whether the entity is
registered in its home state and with what status, and person_verification
compares the person you send with the people named on its registrations. Both
tasks run on the verify package only, and each reports its outcome in
risk_summary.tasks.
Here is the domestic_registration task from the
example response on How checks work. The result
is domestic_active, with the registration in sources.
{ "risk_summary": { "tasks": [ { "task_name": "domestic_registration", "status": "success", "result": "domestic_active", "reason": "An active domestic registration was found", "sources": [ { "issue_date": "2011-04-26", "file_number": "4973743", "registration_state": "DE", "registered_name": "ENIGMA TECHNOLOGIES, INC." } ] } ] }}domestic_registration
Section titled “domestic_registration”Checks whether the matched registered entity has a domestic registration (one filed in its home state) and reports that registration’s status. When there are several, the best one counts: active, then unknown, then inactive.
- Required input: none beyond a match. The
stateyou send affects which business matches, but the task does not check that the domestic registration is in that state.
| Result | Status | Meaning |
|---|---|---|
domestic_active | success | An active domestic registration was found. It is described in sources. |
domestic_unknown | success | A domestic registration was found, but the SoS reports its status as unknown. |
domestic_inactive | failure | A domestic registration was found, but it is inactive and no active or unknown one exists. |
domestic_not_found | failure | No domestic registration with a known status was found. The entity may have only foreign registrations, its domestic registration may have no status, or no business matched. |
Most states do not require sole proprietors to register with the Secretary of
State, so domestic_not_found is common for them. A sole proprietor’s
registered entity has the registered_entity_type Sole Proprietorship. See
Registered entity types.
The registration behind domestic_active is in sources; see
Sources for its fields. For the
registration fields themselves, see
Registered entities.
person_verification
Section titled “person_verification”Compares the person you send with the registered persons (officers and agents) named on the matched registered entity’s registrations.
- Required input: a
person(or one entry inpersons) withfirst_nameandlast_name. With no person, the task returnsperson_not_verified. - Match: the last names are equal and the first names start with the same
letter. Case and punctuation are ignored, and a leading honorific in
first_name(such as Mr, Ms, Dr or Prof) is removed. A suffix inlast_name(such as Jr or III) is compared as sent and can prevent a match. An organization named on a registration, such as a registered agent company, never matches. There is no exact-match result.
| Result | Status | Meaning |
|---|---|---|
person_match | success | The submitted person matches a registered person on the matched registrations. |
person_not_verified | failure | No registered person matches, no person was sent, or no business matched. |
Related
Section titled “Related”- How checks work: every check, the task object and the source fields.
- Registered persons:
the people on the registrations that
person_verificationcompares against. - Person fields: the person you send.
- Verify a business: a request that runs these checks.