List Routing Form Submissions - Zeeg Developer Hub

GET

routing-form-submissions

List routing form submissions

curl --request GET \
  --url https://api.zeeg.me/v2/routing-form-submissions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.zeeg.me/v2/routing-form-submissions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zeeg.me/v2/routing-form-submissions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zeeg.me/v2/routing-form-submissions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.zeeg.me/v2/routing-form-submissions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "status": 200,
  "data": {
    "pagination": {
      "totalItems": 1,
      "perPage": 20,
      "currentPage": 1,
      "lastPage": 1,
      "hasPreviousPage": false,
      "hasNextPage": false
    },
    "submissions": [
      {
        "id": "71621fb7-30b0-4d91-9f2e-a3e009cc6853",
        "createdAt": "2026-04-10T08:30:00+00:00",
        "routingForm": {
          "id": "f1cbafc4-b646-4cf9-af29-193491b555d9",
          "name": "Inbound Lead Qualification",
          "slug": "inbound-lead-qual"
        },
        "route": {
          "type": "EVENT_TYPE",
          "isFallback": false,
          "customUrl": null,
          "headline": null,
          "eventType": {
            "id": "80f46bf5-eb01-4c07-960e-a9a3e18aae5e",
            "title": "30-Minute Discovery Call",
            "slug": "30min-discovery-call",
            "uri": "https://api.zeeg.me/v2/event-types/80f46bf5-eb01-4c07-960e-a9a3e18aae5e"
          },
          "team": null
        },
        "answers": [
          {
            "inputId": "f7c82298-6dd9-43bd-98e4-c437b5c0ae47",
            "order": 1,
            "question": "What is your company size?",
            "type": "text",
            "answer": "50-200 employees",
            "rawAnswer": "50-200 employees",
            "crmAttribute": null
          }
        ],
        "questionsAndAnswers": {
          "What is your company size?": "50-200 employees"
        },
        "utm": {
          "campaign": "spring_launch",
          "source": "linkedin"
        },
        "adAttribution": null
      }
    ]
  }
}

Returns a paginated list of the routing form submissions in your workspace. The submissions of every routing form sit in one feed, so routingFormId filters that feed rather than addressing a sub-resource. Narrow the feed further by creation time with minCreatedAt and maxCreatedAt, and by destination with routeType. Results are newest first. Set sort to asc to read the oldest submission first. Each entry carries the same payload as Get a Routing Form Submission.

Every answer ships twice. Read answer for anything a person sees, and rawAnswer to map the answer into a CRM. The overview explains why.

Authorizations

Authorization

string

header

required

Query Parameters

routingFormId

string<uuid>

Return only the submissions of this routing form. A routing form outside your workspace answers 404.

minCreatedAt

string<date-time>

Return only the submissions that were created at or after this time.

maxCreatedAt

string<date-time>

Return only the submissions that were created at or before this time. It must not precede minCreatedAt.

routeType

enum<string>

Return only the submissions that the given kind of route took.

Available options:

EVENT_TYPE,

URL,

CUSTOM_PAGE,

TEAM_PAGE

sort

enum<string>

default:desc

Sort direction on createdAt.

Available options:

asc,

desc

page

integer

default:1

Page number.

Required range: x >= 1

count

integer

default:20

Number of submissions per page.

Required range: 1 <= x <= 100

Response

success

boolean

Example:

true

status

integer

Example:

200

data

object

Hide child attributes

data.pagination

object

The page counters that a paginated list response carries.

Hide child attributes

data.pagination.totalItems

integer

Number of items that match the request across every page.

Example:

42

data.pagination.perPage

integer

Number of items on one page.

Example:

20

data.pagination.currentPage

integer

Number of the page in this response.

Example:

1

data.pagination.lastPage

integer

Number of the last page.

Example:

3

data.pagination.hasPreviousPage

boolean

True when a page comes before this one.

Example:

false

data.pagination.hasNextPage

boolean

True when a page comes after this one.

Example:

true

data.submissions

object[]

Hide child attributes

data.submissions.id

string<uuid>

Example:

"71621fb7-30b0-4d91-9f2e-a3e009cc6853"

data.submissions.createdAt

string<date-time> | null

Time at which the invitee sent the submission, in UTC.

Example:

"2026-04-10T08:30:00+00:00"

data.submissions.routingForm

object

The routing form that the invitee filled in.

Hide child attributes

data.submissions.routingForm.id

string<uuid>

Example:

"f1cbafc4-b646-4cf9-af29-193491b555d9"

data.submissions.routingForm.name

string

Example:

"Inbound Lead Qualification"

data.submissions.routingForm.slug

string

Example:

"inbound-lead-qual"

data.submissions.route

object

The route that the answers selected, as it stood at the time of the submission.

Hide child attributes

data.submissions.route.type

enum<string> | null

Available options:

EVENT_TYPE,

URL,

CUSTOM_PAGE,

TEAM_PAGE

Example:

"EVENT_TYPE"

data.submissions.route.isFallback

boolean

True when the answers matched no route and the fallback route took the submission.

Example:

false

data.submissions.route.customUrl

string | null

Destination address of a URL route.

Example:

null

data.submissions.route.headline

string | null

The headline that the invitee saw, with the HTML tags removed.

Example:

null

data.submissions.route.eventType

object | null

The event type that a route or a submission points at. It is null when no event type is set.

Hide child attributes

data.submissions.route.eventType.id

string<uuid>

Example:

"80f46bf5-eb01-4c07-960e-a9a3e18aae5e"

data.submissions.route.eventType.title

string

Example:

"30-Minute Discovery Call"

data.submissions.route.eventType.slug

string

Example:

"30min-discovery-call"

data.submissions.route.eventType.uri

string<uri>

Address of the event type in this API.

Example:

"https://api.zeeg.me/v2/event-types/80f46bf5-eb01-4c07-960e-a9a3e18aae5e"

data.submissions.route.team

object | null

The team that a route or a submission points at. It is null when no team is set.

Hide child attributes

data.submissions.route.team.id

string<uuid>

Example:

"3d9b1a77-2c58-4e6a-9f30-8b1c5d4e2f6a"

data.submissions.route.team.title

string

Example:

"Sales EMEA"

data.submissions.route.team.slug

string

Example:

"sales-emea"

data.submissions.answers

object[]

The answers of the submission, in the order of the questions.

Hide child attributes

data.submissions.answers.inputId

string<uuid>

Id of the question that the invitee answered.

Example:

"f7c82298-6dd9-43bd-98e4-c437b5c0ae47"

data.submissions.answers.order

integer

Position of the question in the routing form at the time of the submission. The first question carries 1, so this counter starts one higher than order on the question itself.

Example:

1

data.submissions.answers.question

string | null

The question text at the time of the submission.

Example:

"What is your company size?"

data.submissions.answers.type

string | null

The stored type of the answer, for example text. A question that maps onto a CRM select attribute carries object.

Example:

"object"

data.submissions.answers.answer

string

The display value of the answer. Show this value to a person.

Example:

"50-200 employees"

data.submissions.answers.rawAnswer

string | null

The stored value of the answer. A question that maps onto a CRM select attribute carries the canonical {"id","value","color"} JSON that identifies the option. Map into a CRM by this value.

Example:

"{\"id\":\"size-50-200\",\"value\":\"50-200 employees\",\"color\":\"blue\"}"

data.submissions.answers.crmAttribute

object | null

The CRM attribute that a question maps onto. It is null when the question maps onto no attribute.

Hide child attributes

data.submissions.answers.crmAttribute.objectSlug

string

Slug of the CRM object that holds the attribute.

Example:

"companies"

data.submissions.answers.crmAttribute.attributeSlug

string

Slug of the attribute on that object.

Example:

"industries"

data.submissions.questionsAndAnswers

object

The same answers as a map. The key is the question text, the value is the display answer.

Hide child attributes

data.submissions.questionsAndAnswers.{key}

string

Example:

{
  "What is your company size?": "50-200 employees"
}

data.submissions.utm

object

The UTM parameters that the page carried when the invitee sent the submission. A parameter that carries no value is absent.

Hide child attributes

data.submissions.utm.campaign

string

Example:

"spring_launch"

data.submissions.utm.source

string

Example:

"linkedin"

data.submissions.utm.medium

string

data.submissions.utm.content

string

data.submissions.utm.term

string

data.submissions.adAttribution

object | null

The advertisement click identifiers that the page carried when the invitee sent the submission. It is null when the page carried none.

Hide child attributes

data.submissions.adAttribution.gclid

string

Google Ads click identifier.

data.submissions.adAttribution.fbclid

string

Meta click identifier.

data.submissions.adAttribution.fbp

string

Meta browser identifier.

data.submissions.adAttribution.fbc

string

Meta click cookie value.

data.submissions.adAttribution.landingUrl

string

The address at which the visit started.

Example:

{ "gclid": "Cj0KCQjw_pO_BhDgARIsAOgg" }

Last modified on September 9, 2026

List routing form submissions

curl --request GET \
  --url https://api.zeeg.me/v2/routing-form-submissions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.zeeg.me/v2/routing-form-submissions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zeeg.me/v2/routing-form-submissions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zeeg.me/v2/routing-form-submissions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.zeeg.me/v2/routing-form-submissions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "status": 200,
  "data": {
    "pagination": {
      "totalItems": 1,
      "perPage": 20,
      "currentPage": 1,
      "lastPage": 1,
      "hasPreviousPage": false,
      "hasNextPage": false
    },
    "submissions": [
      {
        "id": "71621fb7-30b0-4d91-9f2e-a3e009cc6853",
        "createdAt": "2026-04-10T08:30:00+00:00",
        "routingForm": {
          "id": "f1cbafc4-b646-4cf9-af29-193491b555d9",
          "name": "Inbound Lead Qualification",
          "slug": "inbound-lead-qual"
        },
        "route": {
          "type": "EVENT_TYPE",
          "isFallback": false,
          "customUrl": null,
          "headline": null,
          "eventType": {
            "id": "80f46bf5-eb01-4c07-960e-a9a3e18aae5e",
            "title": "30-Minute Discovery Call",
            "slug": "30min-discovery-call",
            "uri": "https://api.zeeg.me/v2/event-types/80f46bf5-eb01-4c07-960e-a9a3e18aae5e"
          },
          "team": null
        },
        "answers": [
          {
            "inputId": "f7c82298-6dd9-43bd-98e4-c437b5c0ae47",
            "order": 1,
            "question": "What is your company size?",
            "type": "text",
            "answer": "50-200 employees",
            "rawAnswer": "50-200 employees",
            "crmAttribute": null
          }
        ],
        "questionsAndAnswers": {
          "What is your company size?": "50-200 employees"
        },
        "utm": {
          "campaign": "spring_launch",
          "source": "linkedin"
        },
        "adAttribution": null
      }
    ]
  }
}