List form submissions

Returns paginated submissions for a form. Supports filtering by status (unread, read, archived, spam) and date range.

Required permissions

forms.submissions.view

GET/forms/{id}/submissions

Base URLhttps://api.lynkow.com/v1

Path parameters

idstringrequired: Unique identifier

Query parameters

dateFromstring

Filter from date (ISO 8601)

dateTostring

Filter until date (ISO 8601)

excludeIdsstring[]

Array of strings

idsstring[]

Array of strings

limitnumber

Number <= 100

Max: 100

pagenumber

Number

searchstring

Full-text search query

sortByenum("created_at" | "updated_at" | "status")

One of: created_at, updated_at, status

sortOrderenum("asc" | "desc")

One of: asc, desc

statusenum("new" | "read" | "spam" | "archived")

One of: new, read, spam, archived

View as markdown Install Lynkow Skills

curl --request GET \
  --url 'https://api.lynkow.com/v1/forms/<id>/submissions' \
  --header 'Authorization: Bearer $API_TOKEN'

{
  "data": [
    {
      "id": 501,
      "data": {
        "name": "Sophie Bernard",
        "email": "[email protected]",
        "message": "I would like to know more about your enterprise plan."
      },
      "formId": 1,
      "status": "unread",
      "createdAt": "2025-04-05T16:30:00.000Z",
      "ipAddress": "203.0.113.42",
      "userAgent": "Mozilla/5.0"
    },
    {
      "id": 500,
      "data": {
        "name": "Marc Leroy",
        "email": "[email protected]",
        "message": "Can I schedule a demo?"
      },
      "formId": 1,
      "status": "read",
      "createdAt": "2025-04-04T10:15:00.000Z",
      "ipAddress": "198.51.100.17",
      "userAgent": "Mozilla/5.0"
    }
  ],
  "meta": {
    "total": 134,
    "perPage": 15,
    "lastPage": 9,
    "currentPage": 1
  }
}

Feedback

Path parameters

Query parameters

Was this page helpful?