New service | **Last updated**: 14 May 2025

Important
This documentation is for preview purposes only.

# Verify parties

Verify the identity of your parties and make sure you stay compliant when dealing with different entities.

Prerequisite
To successfully verify a party, you must add certain required details to your party which differ from country to country. You can find the specifications of these details in our [coverage guide](/products/marketplaces/coverage/party-verification/emea/united-kingdom).

You can verify the identity of a [person](/products/parties/create-party#create-a-partyy), a [sole trader](/products/parties/create-party#create-a-party), or a [company](/products/parties/create-party#create-a-party) either **during** or **after** the creation of a party.

To verify a party **during** and [orchestrated party creation call](/products/parties/create-party#orchestrated-party-creation), you can include the `performIdentityVerification` field in your request and set the value as "true".


```
"performIdentityVerification": true
```

## Verify identity of your party

Perform an identity verification check **after** a party is created.

`POST` `https://access.worldpay-bsh.securedataplatform.com/parties/{partyId}/identityVerification`

### Request/response example

See full [schema](/products/parties/openapi/identity-verification) to verify your party.

## View verification outcomes

Query the status of your identity verification check periodically to get status updates.

`GET` `https://access.worldpay-bsh.securedataplatform.com/parties/{partyId}/identityVerification`

### Request/response example:

You can get the following status outcomes:

| Event | Description | Action required? |
|  --- | --- | --- |
| `notVerified` | The identity verification process has not yet started. |  |
| `started` | The identity verification process was is initiated. |  |
| `startedAction` | One or more mandatory fields are missing. Further information is required from the party, in order for the verification process to resume. |  |
| `pending` | The identity verification is in progress. The status will change once the validation has completed. |  |
| `pendingStepUpAction` | The identity verification process is not yet complete. You will receive a URL in the response of your `GET`request with further details on next actions (e.g. uploading a scan of the ID or a liveness check). |  |
| `pendingManualReview` | The identity verification process is being manually reviewed |  |
| `rejected` | The identity verification process has failed and the party's identity is not verified successfully. |  |
| `verified` | The identity verification process has completed successfully and the party's identity is now verified. |  |


Important
Once the party has been successfully verified, you'll receive an `expiryDate` of your party record within your response. The validity of the verification expires depending on the type of party and specific country/region. After this, you must verify the identity of the party again.

#### Next steps

[Add a payout instrument](/products/parties/payout-instruments)
[Manage beneficial owners](/products/parties/beneficial-owners) or 
[Add balance accounts](/products/parties/balance-accounts)