Skip to main content
Hosted journeys use the GBG Go platform to handle the end-user experience. Your backend starts the journey and receives a hosted page URL, which you redirect end users to. The platform handles the verification flow, and your backend polls for journey state to detect when the journey completes.

​
Before you begin

Make sure you have the following in place before using the API:
  • A published hosted journey. To learn how to create and publish a hosted journey, refer to Create journeys. You need the journey’s resource ID and version to start a journey instance.
  • An API client for API authentication, which provides a Client ID and Client secret. You create API clients yourself in the Account management portal. See Manage API clients to create one.

​
Execution flow

A complete hosted journey execution consists of the following steps:
  1. Authenticate: Get access token to authorise API requests.
  2. Start a journey: Create a new journey instance using the published journey’s resource ID. Include config.delivery: "page" to receive an instanceUrl in the response.
  3. Share the instance URL: Send the instanceUrl to the end user, who completes the verification steps on the hosted pages.
  4. Fetch journey state: Poll the journey status to detect completion and retrieve verification results.
Click any step to open its full instructions.
After starting the journey, share the instanceUrl with the end user, either through redirect, email, SMS, or QR code. The hosted pages handle the entire verification experience. Your backend only needs to poll for completion.

​
Reference