REST Endpoints

Complete endpoint reference for the FRITH REST API.

# Base URL for all requests:

https://getfrith.com/api/v1

# Pagination (all list endpoints):

?page=1&limit=20 → returns up to 20 records, page 1

Response includes: { data: [...], meta: { page, limit, total, hasMore } }

Matters

Method	Path	Description
GET	/api/v1/matters	List matters. Filters: status, type, assignedTo, clientId, q (search).
POST	/api/v1/matters	Create a matter. Required: title, type, clientId. Optional: assignedTo, referenceNumber, description.
GET	/api/v1/matters/:id	Retrieve a single matter by ID including parties and billing summary.
PATCH	/api/v1/matters/:id	Update matter fields. Partial update — only provided fields are changed.

Method	Path	Description
GET	/api/v1/contacts	List contacts. Filters: type (client, counsel, witness), q, matterid.
POST	/api/v1/contacts	Create a contact. Required: firstName or companyName, email. Optional: phone, type, address.
PATCH	/api/v1/contacts/:id	Update contact fields.

Method	Path	Description
GET	/api/v1/time-entries	List time entries. Filters: matterId, userId, billed, dateFrom, dateTo.
POST	/api/v1/time-entries	Create a time entry. Required: matterId, duration (minutes), description, billingCode.

Method	Path	Description
GET	/api/v1/invoices	List invoices. Filters: status (draft, sent, paid, overdue), matterId, clientId.
POST	/api/v1/invoices	Create an invoice. Required: matterId, lineItems[]. Optional: dueDate, notes, taxRate.

Method	Path	Description
GET	/api/v1/documents	List documents. Filters: matterId, type, uploadedBy.
POST	/api/v1/documents/upload	Upload a document. Multipart form data: file, matterId, name, type.

Method	Path	Description
GET	/api/v1/tasks	List tasks. Filters: matterId, assignedTo, status (pending, in_progress, completed), dueDate.
POST	/api/v1/tasks	Create a task. Required: title, matterId. Optional: assignedTo, dueDate, priority.