# Signa API Documentation

> Global trademark intelligence platform. Search and retrieve trademarks across USPTO, EUIPO, and WIPO (Madrid) from one API, with more offices rolling out.

## Getting Started
- [Introduction](index.mdx): Platform overview, office coverage, quick example
- [Quickstart](quickstart.mdx): First API call in 5 minutes, SDK setup

## Core Concepts
- [Trademarks](guides/trademarks.mdx): Lifecycle, status taxonomy, key fields
- [Search](guides/search.mdx): Text, phonetic, fuzzy search, filters, aggregations
- [Entities](guides/entities.mdx): Owners, attorneys, firms, entity resolution
- [Deadline Rules](guides/deadline-rules.mdx): 21-jurisdiction ruleset, computation, US Section 8/9
- [Madrid Protocol](guides/madrid-protocol.mdx): International registrations, designations

## How Signa Works
- [Status Taxonomy](guides/status-taxonomy.mdx): 4-axis system, 18 stages, office mappings
- [Data Freshness](guides/data-freshness.mdx): Per-office sync schedules, consistency model
- [Filing Routes](guides/filing-routes.mdx): National vs Madrid vs regional, mark types
- [Entity Resolution](guides/entity-resolution.mdx): Name normalization, SEC/GLEIF matching

## Working with the API
- [Caching](guides/caching.mdx): ETags, conditional requests, strategies
- [Resilience](guides/resilience.mdx): Backoff, retry, circuit breaker patterns
- [Testing](guides/testing.mdx): Sandbox, fixtures, integration test patterns

## Trust & Compliance
- [Data Quality](guides/data-quality.mdx): Office coverage matrix, audit results, freshness SLAs
- [Compliance](guides/compliance.mdx): GDPR, attorney privilege, security, data residency
- [Glossary](guides/glossary.mdx): 25+ trademark terms with API field mappings

## Use Cases
- [Trademark Clearance](guides/use-cases/trademark-clearance.mdx): Brand screening workflow
- [Competitor Intelligence](guides/use-cases/competitor-intelligence.mdx): Track competitor filings
- [Renewal Management](guides/use-cases/renewal-management.mdx): Deadline tracking across jurisdictions
- [M&A Due Diligence](guides/use-cases/mna-due-diligence.mdx): Portfolio evaluation
- [Opposition Tracking](guides/use-cases/opposition-tracking.mdx): TTAB proceedings
- [Class Coverage Audits](guides/use-cases/class-coverage-audits.mdx): Nice class gap analysis
- [Ownership Transfer](guides/use-cases/ownership-transfer.mdx): Post-acquisition workflows

## API Reference
- [Introduction](api-reference/introduction.mdx): Base URL, authentication, request/response format, status codes
- [Pagination](api-reference/pagination.mdx): Cursor-based, stability, sorting, total count
- [Rate Limits & Quotas](api-reference/rate-limits.mdx): Monthly quota pools, per-minute limits, headers, 429 handling
- [Errors](api-reference/errors.mdx): Error catalog, idempotency, troubleshooting
- Trademarks: search, get, list, batch, history, related, suggest, image search, coverage, media, proceedings, source
- Entities: owners (get, list, trademarks, related), attorneys, firms
- Proceedings: list, get
- Reference Data: offices, jurisdictions, statuses, classifications, event types, deadline rules
- Platform: me, usage, API keys, logs

## SDK
- [TypeScript SDK](sdk/overview.mdx): Installation, configuration, usage patterns