ceven

Identitycheck

Automates user identity verification and KYC workflows, monitors onboarding statuses in real time, and manages verification configurations across your security stack.

Try Identitycheck in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Identitycheck integration

    • Describe the outcome and Ceven picks the right Identitycheck calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Identitycheck data, across all 11 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Identitycheck access.
    • Per user and per environment credentials instead of shared keys.

  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Identitycheck, when, and on whose behalf.
    • The agent pauses and asks when Identitycheck is unclear instead of plowing ahead.

  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Identitycheck.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Identitycheck action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Identitycheck, and when to use it.

Check API Health
Use this to verify API availability before starting a batch of onboarding requests to avoid timeout errors.
Delete configuration
Remove an existing verification configuration by its unique code when a specific check logic is no longer required.
Delete Notification Endpoint
Remove a callback URL after confirming the endpoint code exists and you no longer need webhooks for that path.
Fetch All Configurations
Pull a list of all current customer configurations to audit which verification rules are active across the platform.
Fetch all notification endpoints
List all active notification endpoints to ensure webhooks are pointing to the correct listener services.
Fetch Configuration
Pull the detailed settings of a specific identity check configuration using its unique code.
Fetch Notification Endpoint
Retrieve the current settings and configuration of a specific callback endpoint by its code.
Fetch Onboardings
Retrieve a list of onboardings filtered by UID, status, or date range to find specific user verification results.
Get Document Content
Pull the base64 encoded document content using an onboarding UID and document code for manual fraud inspection.
Retrieve Onboarding Status
Check the progress and final result of a specific onboarding request after it has been initiated.
Update Configuration
Modify the properties of an existing identity check configuration identified by its unique code.

11 actions · scroll to see them all

Frequently asked questions

Ceven retrieves document content as base64 encoded strings directly from the IdentityCheck API using the onboarding UID and document code. We do not store these documents in a permanent database. The agent holds the data in volatile memory only long enough to pass it to your specified downstream system, such as a secure S3 bucket or a compliance review tool. Once the workflow step completes and the data is handed off, the memory is cleared. This ensures that sensitive PII like passports or drivers licenses are not cached within the AI layer, maintaining a strict security posture and reducing your data residency footprint.
Yes. You can build a workflow that uses the Retrieve Onboarding Status action to poll for a result. If the status returns as failed, the agent can trigger a secondary path. This might include sending an email to the user via SendGrid requesting a clearer photo of their ID or flagging the account in your CRM for a manual review by a compliance officer. You can define specific logic based on the failure reason provided by IdentityCheck to ensure the user gets a helpful instruction rather than a generic error message, which significantly improves the conversion rate of your onboarding funnel.
Ceven can interact with your various IdentityCheck configurations to apply different rules to different user segments. For example, you can create a workflow that uses the Fetch Configuration action to verify the settings for a low risk region and then uses Update Configuration to tighten the requirements for a high risk region in real time. The agent can switch between these configurations based on the metadata passed during the initial request, allowing you to maintain a flexible security posture that balances user friction with risk mitigation without needing to manually update API calls in your code.
To prevent workflow failures, you can insert the Check API Health action at the start of your sequence. If the health check returns a failure, the agent can be programmed to pause the workflow and alert your engineering team via Slack or PagerDuty. Alternatively, you can set up a retry logic with exponential backoff. Because Ceven tracks the state of the onboarding UID, it can resume the process exactly where it left off once the API is back online, ensuring that no user is left in a pending state indefinitely and no onboarding requests are lost.
Yes. IdentityCheck imposes strict rate limits on the Fetch Onboardings and Get Document Content endpoints to prevent system abuse. Depending on your plan tier, exceeding these limits will result in a 429 Too Many Requests error. Ceven handles this by implementing a request queue that spaces out calls to these specific endpoints. If you are running a massive backfill of historical data, you may notice the agent processing records slower than usual. We recommend scheduling bulk audits during off peak hours to ensure your real time user onboardings are not delayed by background data retrieval tasks.
Ceven can manage your webhook infrastructure by using the Fetch and Delete Notification Endpoint actions. If you rotate your listener URLs or migrate to a new microservice, the agent can automatically delete the old endpoints and verify the new ones are correctly configured. This eliminates the need for a developer to manually update the IdentityCheck dashboard. You can build a synchronization workflow that ensures your production and staging environments always have the correct callback URLs mapped, reducing the risk of missed onboarding notifications during deployment cycles.
While Ceven can technically loop through a list of onboardings and call Get Document Content for each, we recommend against this for large datasets due to the aforementioned rate limits and the sheer volume of base64 data. The best practice is to use the Fetch Onboardings action to identify only the users who failed verification or were flagged for fraud. The agent then retrieves documents only for that specific subset. This targeted approach keeps your workflows efficient and ensures you stay within your API quota while still providing the necessary data for your compliance audits.
Ceven supports real time updates through two methods. First, you can use the Retrieve Onboarding Status action in a polling loop for immediate feedback. Second, you can configure IdentityCheck notification endpoints to send webhooks to a Ceven webhook trigger. When the webhook fires, it kicks off a workflow that processes the status update and pushes it to your internal systems. The webhook method is the most efficient way to handle high volume traffic as it removes the need for constant API polling and ensures your user database is updated the millisecond a verification decision is reached.

Alternatives to Identitycheck

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

Onfido logoOnfidoJumio logoJumioSumsub logoSumsub

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Identitycheck and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free