listFormRecords

GET

/api/v1/data-sources/{id}/records

const url = 'https://example.com/api/v1/data-sources/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/records?sort=newest';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://example.com/api/v1/data-sources/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/records?sort=newest'

Returns a filtered, paginated page of a form’s records. Callers with view_all, review, approve, or manage see every record; a submitter without those sees only their own submissions. mine=true scopes the page to the caller’s own submissions even for privileged callers (the Forms portal’s “your submissions”). Supports states, search, sort, mine, page, and pageSize query parameters.

Parameters

Path Parameters

required

string format: uuid

Query Parameters

states

string

Comma-separated workflow state keys

mine

boolean

Scope to the caller’s own submissions

search

string

sort

string

Allowed values: newest oldest priority updated

page

integer

pageSize

integer

Responses

200

Paginated record page (items, total, page, pageSize)

403

No visibility into this form’s records