> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.
# Firm Trademarks
> List trademarks handled by attorneys at a specific firm with the full Appendix A filter set
## Overview
Returns a paginated list of trademarks where one of the attorneys belongs to the specified firm. Use this for firm-level competitive intelligence, client portfolio sweeps, or auditing prosecution patterns.
When no `sort` parameter is supplied and no `q` text query is given, results are returned in the search index's internal document order (not sorted by any specific field). When a `q` text query is provided, results are ranked by relevance score with filing date as a tiebreaker. You can pass an explicit `sort` parameter to control ordering (e.g. `sort=-filing_date`). Every Appendix A filter from the main [`List Trademarks`](/api-reference/trademarks/list-trademarks) endpoint is available here.
Arrays are comma-separated, date ranges use flat `_gte`, `_gt`, `_lte`, and `_lt` operators, and booleans must be the literal strings `true` or `false`.
## Path Parameters
Firm ID (`firm_...`).
## Query Parameters
### Pagination
Items per page (1-100).
Pagination cursor from a previous response.
### Status filters
Primary status: `active`, `pending`, `inactive`, `unknown`. Accepts a single value or a comma-separated list — e.g. `?status_primary=active,pending` matches TESS-style "live" marks.
Status stage(s), comma-separated.
Status reason(s), comma-separated.
Challenge state(s), comma-separated.
### Mark classification
Mark feature type(s), comma-separated.
Legal category(ies), comma-separated.
Right kind.
Filing route(s), comma-separated.
Scope kind(s), comma-separated.
### Identifiers
Application number. Requires `office`.
Registration number. Requires `office`.
Madrid international registration number.
Office code (required with `application_number` or `registration_number`).
### Geography
Jurisdiction codes, comma-separated.
Office codes, comma-separated (e.g. `?offices=uspto,euipo`).
Owner country code (ISO 3166-1 alpha-2).
### Classification codes
Nice classes 1-45, comma-separated.
Vienna figurative codes, comma-separated.
### Date ranges
Lower bounds must be before upper bounds. Date fields use `YYYY-MM-DD`; `updated_at_*` accepts ISO 8601 timestamps.
Filing date >=.
Filing date >.
Filing date \<=.
Filing date \<.
Registration date >=.
Registration date >.
Registration date \<=.
Registration date \<.
Expiry date >=.
Expiry date >.
Expiry date \<=.
Expiry date \<.
Renewal due date >=.
Renewal due date >.
Renewal due date \<=.
Renewal due date \<.
Publication date >=.
Publication date >.
Publication date \<=.
Publication date \<.
Termination date >=.
Termination date >.
Termination date \<=.
Termination date \<.
Updated at >= (ISO 8601).
Updated at > (ISO 8601).
Updated at \<= (ISO 8601).
Updated at \< (ISO 8601).
### Entity filters
Owner ID (`own_...`).
Fuzzy owner name match.
Attorney ID (`att_...`).
### Public company filters
`true` to return marks whose owner has a confirmed active SEC ticker match. `false` means no confirmed public-company match, not confirmed private.
`true` to return marks whose owner has a confirmed GLEIF LEI match. `false` means no confirmed LEI match.
Exact owner ticker match, uppercased server-side.
Exact owner LEI match, uppercased server-side.
### Boolean flags
Marks with media.
Marks with proceedings.
Madrid-routed marks only.
Retracted marks only.
Series marks only.
## Response
Returns a `list` envelope of trademark summary objects.
```json theme={null}
{
"object": "list",
"data": [
{
"id": "tm_8kLm2nPq",
"object": "trademark",
"mark_text": "AURORA",
"status": { "primary": "active", "stage": "registered" },
"office_code": "uspto",
"jurisdiction_code": "US",
"filing_date": "2023-04-12",
"registration_date": "2024-09-18",
"classifications": [
{ "nice_class": 9, "goods_services_text": "Downloadable software for digital image processing" },
{ "nice_class": 35, "goods_services_text": "Online retail store services featuring digital media" },
{ "nice_class": 42, "goods_services_text": "Software as a service (SaaS) featuring media management tools" }
],
"owner_name": "Aurora Digital Inc."
}
],
"has_more": true,
"pagination": { "cursor": "eyJpZCI6..." },
"request_id": "req_xyz"
}
```
## Code Examples
```bash cURL theme={null}
curl "https://api.signa.so/v1/firms/firm_2kLm9X/trademarks?status_stage=registered&filing_date_gte=2024-01-01&limit=20" \
-H "Authorization: Bearer sig_YOUR_KEY_HERE"
```
```typescript TypeScript theme={null}
import { Signa } from "@signa-so/sdk";
const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });
const page = await signa.firms.trademarks("firm_2kLm9X", {
status_stage: ["registered"],
filing_date_gte: "2024-01-01",
limit: 20,
});
```
```python Python theme={null}
import requests
resp = requests.get(
"https://api.signa.so/v1/firms/firm_2kLm9X/trademarks",
headers={"Authorization": "Bearer sig_YOUR_KEY_HERE"},
params={"status_stage": "registered", "filing_date_gte": "2024-01-01"},
)
```
## Errors
| Status | Type | Description |
| ------ | ------------------ | ------------------------------------- |
| 400 | `validation_error` | Invalid query parameter or date range |
| 401 | `unauthorized` | Missing or invalid API key |
| 404 | `not_found` | Firm ID does not exist |
| 429 | `rate_limited` | Too many requests |
## Related Endpoints
* [Get Firm](/api-reference/parties/get-firm) -- firm profile and stats
* [Firm Attorneys](/api-reference/parties/firm-attorneys) -- attorneys at this firm
* [Attorney Trademarks](/api-reference/parties/attorney-trademarks) -- same view scoped to one attorney