GET/projects/{project_id}/messages

List messages

Retrieve a paginated list of contact messages for a specific project with optional filtering.

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

Parameters

project_idpathstringrequired

Unique identifier of the project (MongoDB ObjectId)

Example: 507f1f77bcf86cd799439011

pagequeryinteger

Page number (1-indexed)

limitqueryinteger

Number of items per page

statusqueryContactMessageStatus

Filter by contact message status

searchquerystring

Search term to filter messages by name, email, subject, or message content

Responses

Request

GET/projects/{project_id}/messages

curl \
  "https://seggwat.com/api/v1/projects/string/messages?page=1&limit=20&status=New&search=string"

Response

200application/json

{
  "messages": [
    {
      "archived": false,
      "created_at": "2024-01-15T10:30:00Z",
      "email": "jane@example.com",
      "id": "507f1f77bcf86cd799439011",
      "message": "I have a question about my subscription invoice.",
      "name": "Jane Smith",
      "path": "/pricing",
      "project_id": "507f1f77bcf86cd799439022",
      "status": "New",
      "subject": "Question about billing",
      "version": "1.2.3"
    }
  ],
  "pagination": {
    "limit": 20,
    "page": 1,
    "total": 42,
    "total_pages": 3
  }
}

Navigation