Search submissions across forms

GET

submissions

curl --request GET \
  --url https://api.formcarry.com/v1/submissions \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.formcarry.com/v1/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.formcarry.com/v1/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.formcarry.com/v1/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.formcarry.com/v1/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

{
  "data": [
    {
      "id": "64c000000000000000000001",
      "form_id": "AbC123xyz",
      "created_at": "2026-01-15T10:00:00.000Z",
      "spam": true,
      "read": true,
      "ip": "<string>",
      "country": "DE",
      "user_agent": "<string>",
      "referer": "<string>",
      "fields": [
        {
          "key": "email",
          "value": "ann@example.com"
        }
      ],
      "attachments": [
        {
          "key": "cv",
          "url": "<string>",
          "mime_type": "application/pdf"
        }
      ]
    }
  ],
  "forms_searched": 12,
  "forms_matched": 14,
  "complete": true
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

status

enum<string>

default:inbox

Which submissions to include: the inbox (default), spam, or both.

Available options:

inbox,

spam,

all

read

enum<string>

Only submissions that have (true) or have not (false) been read in the dashboard.

Available options:

true,

false

has_attachments

enum<string>

Only submissions with (true) or without (false) uploaded files.

Available options:

true,

false

created_after

string

Only submissions created at or after this time (RFC 3339, or milliseconds since the epoch).

created_before

string

Only submissions created before this time (RFC 3339, or milliseconds since the epoch).

country

string

Only submissions sent from this country. Two-letter uppercase code. For several, separate them with commas. Max 20.

string

Only submissions where any field contains this text, matched literally and without case. 2 to 512 characters. On some forms a field that only appeared in very old submissions may be missed, so name that field with a field filter.

order

enum<string>

default:newest

Newest first (the default) or oldest first.

Available options:

newest,

oldest

limit

number

default:25

Matches to return in total across every form searched. This search has no pages.

Required range: 1 <= x <= 100

fields

string

Only return these submitted fields, separated by commas. Everything else about the submission still comes back.

team_id

string

Search this team only. Defaults to every team the key covers.

form_ids

string

Search only these forms, separated by commas. Forms the key cannot read are left out whether or not you name them. Defaults to the 25 most recently active forms the key can read.

Response

data

object[]

required

Matches across the forms searched, each carrying its form_id.

Show child attributes

forms_searched

number

required

How many of forms_matched were read before the search stopped.

Example:

12

forms_matched

number

required

Forms picked for the search: the ones the key can read that matched form_ids, at most 25.

Example:

14

complete

boolean

required

False when the search did not reach every form or every match. Narrow it with form_ids, a date range or team_id.

⌘I

Search submissions across forms

curl --request GET \
  --url https://api.formcarry.com/v1/submissions \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.formcarry.com/v1/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.formcarry.com/v1/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.formcarry.com/v1/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.formcarry.com/v1/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

{
  "data": [
    {
      "id": "64c000000000000000000001",
      "form_id": "AbC123xyz",
      "created_at": "2026-01-15T10:00:00.000Z",
      "spam": true,
      "read": true,
      "ip": "<string>",
      "country": "DE",
      "user_agent": "<string>",
      "referer": "<string>",
      "fields": [
        {
          "key": "email",
          "value": "ann@example.com"
        }
      ],
      "attachments": [
        {
          "key": "cv",
          "url": "<string>",
          "mime_type": "application/pdf"
        }
      ]
    }
  ],
  "forms_searched": 12,
  "forms_matched": 14,
  "complete": true
}

Overview

Endpoints

Legacy API

Search submissions across forms

Authorizations

Query Parameters

Response