Introduction to the API
The IDmeta API enables seamless integration of all products and verification types into your applications, offering global identity verification and business validation capabilities.IDmeta API Collection
Explore the full IDmeta API collection, including endpoints for KYC, government data, KYB, and alternative verifications.
Authentication
To call IDmeta APIs from your application or from tools like Postman, you need an API token associated with your account.Getting an API token
- Log in to the IDmeta system (dashboard).
-
Open your profile: click your profile avatar/name to go to the profile page.
- In the Settings tab, open API Tokens.
-
Click Create token to generate a new API token.
- Copy the token and store it securely. Treat it like a password.
Authorization header when making requests.
How to use our API
Processes
For every verification process, the following steps must be followed:1. Initiate the verification
Begin by creating a new verification using the Create Verification API.The response will return a
verificationId, which you will use throughout the rest of the process.
2. Perform verification checks
Next, call the relevant verification-type APIs defined in your Trust Flow (template).Examples include the Document Verification API, Biometrics Verification API, and Watchlist & AML Screening API.
At this stage, the verification status will automatically update to In Progress.
3. Finalize the verification
Once all required verification checks are completed, call the Finalize Verification API.This step evaluates the results of all performed verification types and sets the final verification status to one of the following:
- Verified
- Review needed
- Rejected
Extra: Adding metadata
To add metadata that will be sent in your webhook, call the Metadata API after the Create Verification API and before you finalize the verification.Data Dictionary
Verification Status Types
Learn what each verification status means and how to interpret it.