---
search:
  tags:
    - matters
    - GET
seo:
  description: >-
    List matters (scope matters:read). Reference for the GET /api/v1/matters
    endpoint in the Basenet Public API.
sidebar:
  label: List matters (scope matters:read)
  badge: GET
title: List matters (scope matters:read)
type: openapi-operation
---
Endpoint: `GET /api/v1/matters`

Authentication: `bearerAuth` (Scoped API token (bnx\_…). Required scopes are noted per operation.)

Parameters:
- `$top` (in query, integer, optional): Page size ($top, max 200).
- `$skip` (in query, integer or null, optional): Offset ($skip).

Responses:
- `200`: Paginated list
- `401`: Unauthenticated
- `403`: Forbidden (missing scope or permission)
- `429`: Rate limited

Response 200 body (`application/json`):
- `items` (array of object, required)
- `items[].id` (string, required)
- `items[].number` (string, required)
- `items[].name` (string, required)
- `items[].status` (string, required)
- `items[].flavor` (string, required)
- `items[].practiceArea` (string or null, required)
- `items[].departmentId` (string or null, required)
- `items[].accessLevelId` (string or null, required)
- `items[].solicitorResponsibleRelationId` (string or null, required)
- `items[].startDate` (string or null, required)
- `items[].closedDate` (string or null, required)
- `items[].createdAt` (string, required)
- `items[].updatedAt` (string, required)
- `items[].legalAid` (object, optional)
- `items[].legalAid.present` (boolean, required)
- `items[].legalAid.stage` (one of `"none"`, `"requested"`, `"assigned"`, required)
- `items[].legalAid.hourlyFrom` (string or null, required)
- `items[].legalAid.continuesAsHoursMatter` (boolean, required): Deprecated: derived as hourlyFrom !== null. Prefer hourlyFrom for the dated switch.
- `items[].legalAid.filter` (one of `"yes"`, `"no"`, `"hours"`, required)
- `total` (integer, required)
- `skip` (integer, required)
- `top` (integer, required)