List Testimonial Walls

Retrieve a paginated list of testimonial walls in your workspace. Drafts and published testimonial walls are both included.

Request

GET /walls

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number. A missing, non-numeric, zero, or negative value is treated as 1 and does not return an error. A page past the end returns an empty data array and 200.
per_page	integer	25	Items per page (min: 1, max: 100). Anything else is 422.

Ordering: Results are ordered by updated_at descending (most recently updated first).

Example Request

curl -X GET "https://app.easy.tools/api/v1/walls?page=1&per_page=25" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Response

Success Response (200 OK)

{
  "data": [
    {
      "id": "2b7e9d14-6a83-4c50-8f16-5d3a1c9e7b42",
      "slug": "customer-stories",
      "name": "Customer stories",
      "status": "draft",
      "created_at": "2026-01-15T10:30:00.000Z",
      "updated_at": "2026-01-15T10:30:00.000Z",
      "published_at": null
    },
    {
      "id": "4a0c8e55-1d69-4b72-9f30-7c2e6b1a8d94",
      "slug": "product-reviews",
      "name": "Product reviews",
      "status": "published",
      "created_at": "2026-01-10T08:00:00.000Z",
      "updated_at": "2026-01-12T16:45:00.000Z",
      "published_at": "2026-01-12T16:45:00.000Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 1,
    "per_page": 25,
    "total": 2
  }
}

Response Fields

Each entry in data has the fields described in Testimonial Wall Object.

Pagination Object

Field	Type	Description
current_page	integer	Current page number
total_pages	integer	Number of result pages. 0 when the list is empty.
per_page	integer	Number of items per page
total	integer	Total number of testimonial walls in the workspace

Error Responses

Validation Error (422 Unprocessable Entity)

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The given data was invalid",
    "details": {
      "per_page": ["per_page must not be greater than 100"]
    }
  }
}

Authentication, permission, and rate-limit errors are described in Authorization.