Retrieve user replies through API calls when you need on-demand access to response data. Use session IDs to fetch specific user responses from your funnels.

Data structure

Replies are provided in JSON format. Each reply is an object inside the replies list with the following string parameters:
  • element_id - ID of the input element
  • screen_id - ID of the screen where the input element is located
  • value - Exact reply: chosen option, typed text, selected date
For example, if a user selects option 3 with Value czuhQ in an Options element with ID optpic, the resulting JSON looks like this:
{
  "element_id": "optpic",
  "screen_id": "z6DpwUSr",
  "value": "czuhQ"
}
Screen ID will match screen_id only if you set a custom screen ID. Default screen IDs display in the Editor as screen_[actual ID]. For example, screen_z6DpwUSr becomes z6DpwUSr in the JSON response.

Get session ID

To retrieve replies, you need the profile’s session ID. You can obtain it through several methods:

From webhooks

If you use FunnelFox webhooks, you’ll receive the session ID in the session_id parameter with every webhook event.
If you’re not using FunnelFox webhooks yet, learn how to enable them in the webhooks article.

From Adapty integration

If you have Adapty integration enabled, find FunnelFox IDs attached to your Adapty profiles:
  1. Get the Adapty user profile created by FunnelFox
  2. Get Session ID from custom attributes using key fnflfx_session_id
If you haven’t set up Adapty in FunnelFox yet, see the Adapty setup guide.

From Qonversion integration

If you have Qonversion integration enabled, find FunnelFox IDs attached to your Qonversion users:
  1. Get the Qonversion user profile created by FunnelFox
  2. Get session ID from custom attributes using key fnflfx_session_id
If you haven’t linked your FunnelFox project to Qonversion yet, see the Qonversion integration guide.

Make API requests

Once you have the Session ID, use it to retrieve replies through our API. The API returns JSON with replies that your system can parse. You can find payload examples in the API reference.
Contact our support to get your project’s Fox-Secret key for API authentication.
If you don’t have a session ID or Fox-Secret key yet, use the “Example” dropdown in the RESPONSE section and select “200” to see an example JSON response.