Get Form Submissions

Overview

• Retrieve submitted form entries for a specific form.
• Supports pagination using limit and lastKey.
• Results are returned in descending order (latest submissions first).
• This API is protected and requires an internal authorization token.

---

Endpoint

GET /f/{formId}/submissions

Full URL: https://api.cloudmysite.com/forms/f/{formId}/submissions

---

Request

Path Params

Param	Type	Required	Description
formId	string	✅ Yes	Form ID

---

Query Params

Param	Type	Required	Description
limit	number	❌ No	Number of records to fetch (default: 10)
lastKey	string	❌ No	Pagination key from previous response

---

Headers

Header	Type	Required	Description
Authorization	string	✅ Yes	Bearer INTERNAL_PROVISION_TOKEN

---

Response

Success (200)

{
  "success": true,
  "submissions": [
    {
      "form_id": "12344ju",
      "data": {
        "name": "User 1 ",
        "message": "Need to contact regarding query",
        "phone": "3234534",
        "email": "[email protected]"
      },
      "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/146.0.0.0",
      "ip": "1.1.1.1",
      "email": "[email protected]",
      "country": "US",
      "timestamp": "1775315402"
    }
  ],
  "lastKey": null
}

Pagination

• Use lastKey i.e timestamp from response to fetch next set of results
• Pass it as a string in query param

Example:

?limit=10&lastKey={"form_id":"abc123","timestamp":"1775315402"}

cURL Examples

Basic Request

curl -X GET "https://api.cloudmysite.com/forms/f/{formId}/submissions" \
  -H "Authorization: Bearer <INTERNAL_PROVISION_TOKEN>"

With Pagination

curl -X GET "https://api.cloudmysite.com/forms/f/{formId}/submissions?limit=10&lastKey={\"form_id\":\"abc123\",\"timestamp\":\"1775315402\"}" \
  -H "Authorization: Bearer <INTERNAL_PROVISION_TOKEN>"

Error Responses

401 - Unauthorized

{
  "message": "Unauthorized"
}

500 - Internal Server Error

{
  "error": "Something went wrong"
}

Notes

• Requires valid INTERNAL_PROVISION_TOKEN in Authorization header
• Token protects API from unauthorized access (internal use only)
• Returns submissions in descending order (latest first)
• Supports pagination using lastKey