Skip to main content
GET
curl

Authorizations

Authorization
string
header
required

A key generated from Settings → Developers, sent as Authorization: Bearer dr_live_<12 hex chars>_<64 hex chars>. Keys carry explicit scopes — each endpoint states the one it requires. The full key is shown exactly once at generation time and cannot be retrieved again; only the keyId prefix is shown afterward. A revoked key fails auth on its very next request.

Path Parameters

id
string<uuid>
required

The id of a form document.

Query Parameters

from
string<date-time>
required

Start of the range, inclusive. RFC 3339 with Z or a numeric offset.

to
string<date-time>
required

End of the range, exclusive. RFC 3339 with Z or a numeric offset. At most 366 days after from.

Response

The funnel for the range.

documentId
string<uuid>
required

The id of the form the numbers are for.

from
string<date-time>
required

Start of the range as requested, in UTC (inclusive).

to
string<date-time>
required

End of the range as requested, in UTC (exclusive).

steps
object[]
required

Always the three steps, in order. Independent counts of records created in the range, not a linked cohort.

conversionRate
number
required

submitted / visited, 4 decimals; 0 with no visitors; can exceed 1.

dropOff
integer
required

clicked_submit minus submitted, never below 0.