Both authenticate with the app’s App ID and App Secret. See Authentication.
REST endpoints
Errors share one envelope. See Error Codes.
In the API playground, enter the App ID as the username and the App Secret as the password.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Hopae Connect v2 has two surfaces: the OIDC provider for the hosted flow, and the Verification REST API. Both use your App ID and App Secret.
| Surface | Base URL | Use it for |
|---|---|---|
| OIDC | https://connect.hopae.com/v2 (issuer https://connect.hopae.com) | The hosted flow. See Base URL |
| Verification REST API | https://api.hopae.com/connect/v2 | Driving a verification from your backend |
| Method | Path | Purpose |
|---|---|---|
GET | /connections | Connections your app can verify with |
POST | /verifications | Start a verification |
GET | /verifications/{verificationId} | Check the status |
GET | /verifications/{verificationId}/userinfo | Read the result |
DELETE | /verifications/{verificationId} | Cancel |
POST | /verifications/{verificationId}/dc-request | dc only: get the wallet request to run on your own page |
POST | /verifications/{verificationId}/dc-response | dc only: submit the wallet’s answer |
