List Legal Pages

Retrieve a paginated list of legal pages in your workspace. Drafts and published legal pages are both included.

Request

GET /legals

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/legals?page=1&per_page=25" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Response

Success Response (200 OK)

{
  "data": [
    {
      "id": "91e4c0a8-3f72-4b15-a6d9-0e8c2f5b1d63",
      "slug": "site-policies",
      "name": "Site policies",
      "status": "draft",
      "created_at": "2026-01-15T10:30:00.000Z",
      "updated_at": "2026-01-15T10:30:00.000Z",
      "published_at": null
    },
    {
      "id": "e7b2d063-8c41-4f9a-a5e8-3d1c6f0b2a59",
      "slug": "terms",
      "name": "Terms",
      "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 Legal Page 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 legal pages 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.