Retrieving entity verification results

When an entity has finished processing, you can retrieve the verification results.

Verifications typically take ~2 minutes on average to process. When an entity has finished processing, use this endpoint to retrieve extracted registry data along with the verification result.


Retrieving the result

POST /api-entity-status

Retrieve the verification status, and extracted registry data.

NameValue

Content-Type

multipart/form-data

Authorization

Bearer YOUR_TOKEN

Body

NameTypeDescription

applicantId

string

Unique applicantId generated on entity creation (required)

Request

curl --location 'https://enterprise.personr.co/api/1.1/wf/api-entity-status' \
--form 'applicantId="4242424242424x424242424242424242"'

Response

{
    "status": "success",
    "response": {
        "applicantStatus": "Reviewed",
        "reviewAnswer": "Approved",
        "createdDate": "12/09/2024",
        "rejectLabels": [],
        "entityName": "ABC Pty Ltd",
        "registrationNumber": "000000000",
        "entityType": "Australian Proprietary Company, Limited By Shares",
        "incorporatedOn": "12/12/2020",
        "entityCountry": "AUS",
        "registrySource": "Australian Securities & Investments Commission",
        "registeredAddress": "123 Example Lane, Perth, 6000, WA, Australia",
        "representativeEmail": "example@personrco",
        "representativePhone": "0400000000",
        "sourceKey": "Example Source Key",
        "externalUserId": []
    }
}

If your flow contains a custom questionnaire, see Retrieving entity questionnaire answers to retrieve the questions and answers.

Applicant Status Types

Created The entity has been created.

Pre-Checked The entity's documents are being processed.

Pending The entity's data is being processed.

Reviewed The verification is complete, and results are ready.

Review Answer Types

Approved The entity has successfully been verified.

Rejected The entity wasn't able to be verified. Look at rejectLabels to see why.

See the next page for a list of rejection labels, and what they mean.

Last updated