For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Help CenterOpenAPI SpecStatus
OverviewInquiriesTransactionsRelaysAPI ReferenceChangelog
OverviewInquiriesTransactionsRelaysAPI ReferenceChangelog
  • Overview
    • Inquiries Overview
    • Inquiry Model Lifecycle
    • Inquiry Templates
  • Managing inquiries
    • Creating Inquiries
    • Resuming Inquiries
    • Accessing Inquiry status and data
  • Hosted Flow integration
      • Parameters
      • Prefilling Fields
      • Redirecting after Inquiry
      • Security
      • Subdomains
      • WebView Considerations
  • Embedded Flow integration
  • Mobile SDK integration
    • Overview
    • Webview
  • Troubleshooting
    • Troubleshooting Steps
    • Troubleshooting Common Issues
LogoLogo
Help CenterOpenAPI SpecStatus
On this page
  • Query parameters
  • Redirect query parameters
Hosted Flow integrationReference guides

Redirecting After Inquiry

Was this page helpful?
Previous

Security

Next
Built with

Set the redirect-uri query parameter of the hosted flow link to your URL for processing responses from Persona. When the hosted flow completes, it will redirect to your URL with an inquiry-id query parameter. redirect-uri can also be set at the template level.

Your server should optionally expect a reference-id GET parameter if you provided one when starting the flow. For example, if your URL is http://withpersona.com/fake-path then you can expect the hosted flow to redirect to http://withpersona.com/fake-path?inquiry-id=<your inquiry ID starting with inq_>&reference-id=12345. For more detail on retrieving inquiries with the inquiry-id, see /api/v1/inquiries/.

redirect-uri supports custom schemes such as mobile intents.

If you have configured Allowed Domains, your redirect-uri’s domain must be a permitted domain.

Query parameters

Specify the following parameters when creating the inquiry to redirect on completion.

ParameterOptionalDescription
redirect-uriOnce the inquiry enters either the Completed or Failed status, we redirect the user back to this URL. The callback should expect a GET parameter named inquiry-id that references the inquiry.
reference-idOptionalYou can generate and provide a unique id which we will associate with the inquiry. The identifier can be used to monitor user progress in newly created inquiries.

Redirect query parameters

When redirecting, Persona will specify the following query parameters.

ParameterNullable
inquiry-idID of the inquiry.
reference-idNullableIf you set a reference ID on the request, it will be on the response.
statusStatus of the completed inquiry (e.g. 'completed', 'failed').
fieldsA map of field types and values. See Fields documentation.