---
title: "List filings"
method: GET
path: "/filings"
tags: ["Filings"]
---

# List filings

`GET /filings`

## Request

- Base URL: `https://api.markmesh.com/v1`
- URL: `https://api.markmesh.com/v1/filings`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Trademark filings — one row per (trademark, office) tuple. Office is the source of truth for lifecycle status, dates, and mark metadata; the local row mirrors what the office reports. Updates to customer-managed fields go through PATCH; office-sourced fields refresh via `/refresh_from_office`.

**Filterable attributes**: `applicant_reference`, `application_number`, `closed_reason`, `colour_claim`, `colour_claim_text`, `description`, `expiry_date`, `filing_date`, `filing_type`, `id`, `internal_reference`, `mark_text`, `mark_type`, `ncl_edition`, `official_status`, `owner_name`, `publication_date`, `publication_number`, `registration_date`, `registration_number`, `renewal_date`, `renewal_status`, `representative_name`, `retention_status`, `status`, `status_since`. See the `Filtering` section under Introduction for the query syntax.

**Sortable attributes**: `applicant_reference`, `application_number`, `basic_application`, `basic_registration`, `closed_reason`, `colour_claim`, `colour_claim_text`, `description`, `expiry_date`, `filing_date`, `filing_type`, `id`, `internal_reference`, `mark_text`, `mark_type`, `ncl_edition`, `notes`, `official_status`, `owner_name`, `priority_claims`, `publication_date`, `publication_number`, `registration_date`, `registration_number`, `renewal_date`, `renewal_status`, `representative_name`, `retention_status`, `status`, `status_since`. See the `Sorting` section under Introduction for the syntax.

## Response `200`

Success

## Other responses

- `401`: API key or session credential missing, invalid, expired, or revoked

---

[API](https://skmtc.dev/markmesh/apis/markmesh-api.md) · [All operations](https://skmtc.dev/markmesh/apis/markmesh-api/llms.txt) · [OpenAPI document](https://skmtc.dev/markmesh/apis/markmesh-api/revisions/87d08d2479ee?raw)