List Firms

curl --request GET \
  --url https://api.signa.so/v1/firms \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.signa.so/v1/firms', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.signa.so/v1/firms",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.signa.so/v1/firms"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.signa.so/v1/firms")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "id": "firm_2kLm9X",
      "object": "firm",
      "name": "Smith & Associates LLP",
      "canonical_name": "SMITH & ASSOCIATES LLP",
      "country_code": "US",
      "attorney_count": 42,
      "trademark_count": 15823,
      "active_count": 13640,
      "grant_rate": 0.78,
      "latest_filing": "2026-04-08",
      "created_at": "2024-09-12T11:42:01Z"
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJpZCI6..." },
  "request_id": "req_xyz"
}

GET

firms

List Firms

curl --request GET \
  --url https://api.signa.so/v1/firms \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.signa.so/v1/firms', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.signa.so/v1/firms",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.signa.so/v1/firms"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.signa.so/v1/firms")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "id": "firm_2kLm9X",
      "object": "firm",
      "name": "Smith & Associates LLP",
      "canonical_name": "SMITH & ASSOCIATES LLP",
      "country_code": "US",
      "attorney_count": 42,
      "trademark_count": 15823,
      "active_count": 13640,
      "grant_rate": 0.78,
      "latest_filing": "2026-04-08",
      "created_at": "2024-09-12T11:42:01Z"
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJpZCI6..." },
  "request_id": "req_xyz"
}

Overview

Returns a paginated list of law firms derived from attorney affiliations on ingested trademarks. Filter by country, attorney count, filing volume, and sort by activity metrics.

Recent changes

The beta ?include=stats option has been removed; always-on summary fields now carry the supported firm counts.

Query Parameters

string

Case-insensitive substring search on firm name.

string

ISO 3166-1 alpha-2 country code filter.

integer

Minimum number of attorneys at the firm.

integer

Minimum number of trademark filings handled.

string

default:"-trademark_count"

Sort field. One of -trademark_count, trademark_count, -attorney_count, attorney_count, -grant_rate, grant_rate, -name, name.

integer

default:"20"

Page size (1-50).

string

Pagination cursor from a previous response.

Response

object[]

Array of firm summary records.

string

Firm ID (firm_...).

string

Display name of the firm.

string

Normalized name used for entity resolution.

string

Two-letter country code.

integer

Number of distinct attorneys at the firm.

integer

Total trademarks handled by the firm’s attorneys. Counts marks: a Madrid IR family counts once, matching the default grouped GET /v1/trademarks listings.

integer

Count of active trademarks (registered + pending). Always present; 0 when stats not yet computed.

number

Share of concluded prosecutions (registered + expired + cancelled) that were ever granted (0-1).

string

ISO date of the most recent filing handled.

string

ISO 8601 timestamp when this firm record was created.

{
  "object": "list",
  "data": [
    {
      "id": "firm_2kLm9X",
      "object": "firm",
      "name": "Smith & Associates LLP",
      "canonical_name": "SMITH & ASSOCIATES LLP",
      "country_code": "US",
      "attorney_count": 42,
      "trademark_count": 15823,
      "active_count": 13640,
      "grant_rate": 0.78,
      "latest_filing": "2026-04-08",
      "created_at": "2024-09-12T11:42:01Z"
    }
  ],
  "has_more": true,
  "pagination": { "cursor": "eyJpZCI6..." },
  "request_id": "req_xyz"
}

Code Examples

curl "https://api.signa.so/v1/firms?country_code=US&min_filings=500&sort=-trademark_count&limit=20" \
  -H "Authorization: Bearer sig_YOUR_KEY"

import { Signa } from "@signa-so/sdk";

const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

const page = await signa.firms.list({
  country_code: "US",
  min_filings: 500,
  sort: "-trademark_count",
  limit: 20,
});

Errors

Status	Type	Description
400	`validation_error`	Invalid query parameter
401	`unauthorized`	Missing or invalid API key
403	`forbidden`	API key lacks the `trademarks:read` scope
429	`rate_limited`	Too many requests

Get Firm: full firm detail with optional includes
Firm Attorneys: attorneys at a firm
Firm Trademarks: marks handled by a firm
List Attorneys: search attorneys instead

Overview

Trademarks

Parties

Records

Monitoring

Reference

Analytics

Bulk & Sync

Administration

SDK

List Firms

Overview

Recent changes

Query Parameters

Response

Code Examples

Errors

​Overview

​Recent changes

​Query Parameters

​Response

​Code Examples

​Errors

​Related Endpoints

Overview

Recent changes

Query Parameters

Response

Code Examples

Errors

Related Endpoints