Docs
Contacts

A contact's form leads

GEThttps://api.norreach.app/v1/contacts/{id}/leads

The landing-page forms this contact filled in, newest first (up to 50, spam left out).

pages:readOperation id: list_contact_leads
GET/contacts/{id}/leads
curl -X GET "https://api.norreach.app/v1/contacts/{id}/leads" \
  -H "Authorization: Bearer $NORREACH_API_KEY"
A contact's form leads
{
  "object": "list",
  "data": [
    {
      "id": "6b7c8d9e-0f1a-4b2c-9d3e-4f5a6b7c8d9e",
      "object": "lead",
      "page_id": "5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d",
      "contact_id": "7d1c3b2a-5e4f-4a1b-9c8d-0e1f2a3b4c5d",
      "status": "new",
      "created_at": "2026-11-04T09:12:33.120Z",
      "network": "meta",
      "ad_key": null,
      "campaign": "november",
      "marketing_opt_in": "yes",
      "name": "Maja Lind",
      "email": "maja.lind@example.com",
      "phone": null,
      "answers": [
        {
          "key": "role",
          "label": "Role",
          "value": "Nurse"
        }
      ],
      "page_title": "Nurses when you need them",
      "page_url": "https://acme.norreach.page/nurses-stockholm"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication: send Authorization: Bearer <key>, with an API key or an OAuth access token. The key needs the scope pages:read. API keys and scopes

Path parameters

idstring (uuid)pathrequired

An id (UUID).

Response

200application/json— A contact's form leads

object"list"required
dataobject[]required
Show child attributes
data[].idstring (uuid)required

An id (UUID).

data[].object"lead"required
data[].page_idstring (uuid)required

An id (UUID).

data[].contact_idstring (uuid) | nullrequired
data[].statusstringrequired
data[].created_atstringrequired

RFC 3339 UTC timestamp with milliseconds.

data[].networkstring | nullrequired

The ad network the visitor came from, if any.

data[].ad_keystring | nullrequired
data[].campaignstring | nullrequired
data[].marketing_opt_inenumrequired
One of:yesnonot_asked
data[].namestringrequired
data[].emailstring | nullrequired
data[].phonestring | nullrequired
data[].answersobject[]required
Show child attributes
data[].answers[].keystringrequired
data[].answers[].labelstring | nullrequired
data[].answers[].valuestring | booleanrequired
data[].page_titlestringrequired
data[].page_urlstring | nullrequired
has_morebooleanrequired
next_cursorstring | nullrequired

Errors

Errors are application/problem+json with a stable code.

StatusCodeMeaning
400bad_requestThe request couldn't be read.
400unknown_fieldThe request has a field this operation doesn't know.
401unauthorizedA valid API key is required.
403insufficient_scopeThis API key doesn't have the scope this operation needs.
403feature_not_enabledThe API isn't switched on for this workspace.
404not_foundThat doesn't exist.
429rate_limitedToo many requests. Slow down and try again.
500server_errorSomething went wrong on our side.
503unavailableThe API isn't available right now. Try again shortly.