Obtain OAuth 2.0 access tokens by POST-ing your API key and secret (as HTTP Basic Auth) to the Jumio token endpoint; use the returned access_token for subsequent requests.
Create an account or retrieve an existing one via the accounts endpoint, associating the user with a customerInternalReference for your records.
Initiate a transaction (web or SDK) by calling the initiate endpoint on the account; specify the desired workflow ID (Jumio uses numbered workflow IDs to represent verification types such as ID-only or ID plus liveness).
Return the web URL or SDK initialization token to the client and launch the Jumio Web SDK or mobile SDK so the user can capture their document and selfie.
Configure a callback URL in the Jumio portal; Jumio will POST the transaction result including decision, extracted data fields, and any rejection reasons when processing completes.
Retrieve the full transaction detail via the retrieval API using the account and transaction IDs if you need more granular image-level data beyond the callback payload.
Known gotchas
OAuth access tokens are short-lived; implement token refresh logic rather than hardcoding a token.
Workflow IDs differ between Jumio environments and customer configurations; confirm the correct workflow ID with Jumio support for your contract.
Jumio has rebranded and restructured its product lines over time; verify that you are using the current KYX Platform API rather than a legacy endpoint.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp