# Lobbying Disclosure

> Search the US Lobbying Disclosure Act filings at LDA.gov: who lobbies Congress and the federal government for whom, on which issues and for how much, from registrations and quarterly reports, plus the political contributions lobbyists report. Look up registrants, clients and lobbyists, and run a workflow when a client, firm or lobbyist files. No account or API key required.

App · 11 actions. Web page: https://docs.lodol.com/docs/integrations/lobbying-disclosure

## Actions

### Get a client

Get one client by its ID: its name, description, location, the registrant that lobbies for it and since when.

**Inputs**

- Client ID (`client_id`, text, required): The client's ID, from a search or a filing.

**Outputs**

- `client_id` (number): The client's ID: what 'Get a client' takes.
- `country` (text): Its country's two-letter code.
- `country_name` (text): Its country by name.
- `description` (text): What it does, as the registrant describes it.
- `effective_date` (text): When the registrant began lobbying for it (YYYY-MM-DD).
- `is_government_entity` (true/false): True when the client is a state or local government or one of its bodies.
- `name` (text): Its name, such as MICROSOFT CORPORATION.
- `ppb_country` (text): The country of its principal place of business.
- `ppb_state` (text): The state of its principal place of business.
- `registrant_id` (number): The registrant that lobbies for it: what 'Get a registrant' takes.
- `registrant_name` (text): That registrant's name.
- `state` (text): Its state's two-letter code.
- `state_name` (text): Its state by name.

**Example output**

```json
{
  "client_id": 64261,
  "country": "US",
  "country_name": "United States of America",
  "description": "Multinational Technology Conglomerate.",
  "effective_date": "2025-02-02",
  "is_government_entity": null,
  "name": "MICROSOFT CORPORATION",
  "ppb_country": "US",
  "ppb_state": "DC",
  "registrant_id": 682,
  "registrant_name": "AKIN GUMP STRAUSS HAUER & FELD",
  "state": "DC",
  "state_name": "District of Columbia"
}
```

### Get a contribution report

Get one contribution report (LD-203) in full: who filed it, the PACs they run, and every contribution with its contributor, payee, honoree, amount and date.

**Inputs**

- Report (`report`, text, required): The report's UUID, from 'Search contribution reports', or its link on LDA.gov.

**Outputs**

- `address` (text): The filer's street address.
- `city` (text): The filer's city.
- `comments` (text): The filer's comments, when given.
- `contact_name` (text): Whom to contact about the report.
- `contribution_count` (number): How many contributions it lists.
- `contribution_total` (number): What they add up to, in dollars.
- `contributions` (list): Every contribution it lists.
- `country` (text): The filer's country.
- `document_url` (text): The report as LDA.gov shows it, to open or print.
- `filer_type` (text): Who filed it: lobbyist (one lobbyist's own report) or organization (the registrant's).
- `filing_period` (text): The half year it covers: mid_year or year_end.
- `filing_period_name` (text): The period by name, such as '4th Quarter (Oct 1 to Dec 31)'.
- `filing_type` (text): MM a mid year report, MA its amendment, YY a year end report, YA its amendment.
- `filing_type_name` (text): Its type by name, such as Year-End Report.
- `filing_uuid` (text): The report's UUID: what 'Get a contribution report' takes.
- `filing_year` (number): The year it covers, such as 2025.
- `lobbyist_id` (number): The lobbyist who filed it, on a lobbyist's report: what 'Get a lobbyist' takes.
- `lobbyist_name` (text): That lobbyist's name.
- `no_contributions` (true/false): True when the filer reported no contributions in the period.
- `pacs` (list): The political action committees the filer runs or controls.
- `posted_at` (text): When it was posted publicly, in US Eastern time with its offset, such as 2026-10-23T15:36:13-04:00.
- `registrant_id` (number): The registrant's Senate ID: what 'Get a registrant' takes.
- `registrant_name` (text): The registrant the report is filed under.
- `state` (text): The filer's state's code.
- `zip` (text): The filer's ZIP code.

**Example output**

```json
{
  "address": "1111 14th Street NW, Suite 1100",
  "city": "Washington",
  "comments": null,
  "contact_name": "JAMES SCHULZ, JR.",
  "contribution_count": 2,
  "contribution_total": 10000.0,
  "contributions": [
    {
      "amount": 5000.0,
      "contributor": "SELF",
      "date": "2025-07-21",
      "honoree": "Lindsey Graham",
      "payee": "TEAM GRAHAM, INC.",
      "type": "feca",
      "type_name": "FECA"
    },
    {
      "amount": 5000.0,
      "contributor": "SELF",
      "date": "2025-07-21",
      "honoree": "Lindsey Graham",
      "payee": "FUND FOR AMERICA'S FUTURE",
      "type": "feca",
      "type_name": "FECA"
    }
  ],
  "country": "United States of America",
  "document_url": "https://lda.gov/filings/public/contribution/f4722cff-125e-43f1-82f7-9bb72147c426/print/",
  "filer_type": "organization",
  "filing_period": "year_end",
  "filing_period_name": "Year-End (July 1 to Dec 31)",
  "filing_type": "YA",
  "filing_type_name": "Year-End Amendment",
  "filing_uuid": "f4722cff-125e-43f1-82f7-9bb72147c426",
  "filing_year": 2025,
  "lobbyist_id": null,
  "lobbyist_name": null,
  "no_contributions": false,
  "pacs": [
    "American Dental Political Action Committee"
  ],
  "posted_at": "2026-08-11T15:16:57-04:00",
  "registrant_id": 2228,
  "registrant_name": "AMERICAN DENTAL ASSOCIATION",
  "state": "DC",
  "zip": "20005"
}
```

### Get a lobbying filing

Get one registration or quarterly report in full: the registrant and client, the amount, and for each issue area what was lobbied on, by which lobbyists (with the government jobs they held) and before which parts of the government, plus any foreign entities, affiliated organizations and convictions disclosed.

**Inputs**

- Filing (`filing`, text, required): The filing's UUID, from 'Search lobbying filings', or its link on LDA.gov.

**Outputs**

- `activities` (list): Each issue area lobbied on, with what, by whom and before whom.
- `affiliated_organizations` (list): Organizations that fund the lobbying and take part in it.
- `amount` (number): The amount the filing reports: the income, or else the expenses. Empty on a registration, and when it was under $5,000.
- `client` (object): The client in full.
- `client_id` (number): The client's ID (one per registrant it hires): what 'Get a client' takes.
- `client_name` (text): The client: whom the lobbying was for.
- `conviction_disclosures` (list): Convictions a lobbyist disclosed (bribery, extortion and the like).
- `document_url` (text): The filing as LDA.gov shows it, to open or print.
- `expenses` (number): What an organization lobbying for itself spent in the period, in dollars.
- `expenses_method` (text): How an organization counted its expenses (methods A, B or C), when it reports them.
- `filing_period` (text): The period it covers: first_quarter, second_quarter, third_quarter, fourth_quarter, mid_year or year_end.
- `filing_period_name` (text): The period by name, such as '4th Quarter (Oct 1 to Dec 31)'.
- `filing_type` (text): Its type code: RR a registration, Q1 to Q4 a quarterly report, 1A to 4A an amendment, 1T to 4T a termination (Y at the end: no activity).
- `filing_type_name` (text): Its type by name, such as '4th Quarter Report'.
- `filing_uuid` (text): The filing's UUID, such as 5feb9933-1ef3-43d3-9d42-a558a4ca11cf: what 'Get a filing' takes.
- `filing_year` (number): The year it covers, such as 2025.
- `foreign_entities` (list): Foreign entities that own, control or fund the client.
- `government_entities` (list): The parts of the government contacted, such as SENATE or the FCC.
- `income` (number): What a lobbying firm was paid by the client in the period, in dollars.
- `issue_areas` (list): The issue areas lobbied on, by name, such as Taxation/Internal Revenue Code.
- `issue_codes` (list): The issue areas lobbied on, as codes such as TAX.
- `lobbyists` (list): Everyone who lobbied, once each.
- `posted_at` (text): When it was posted publicly, in US Eastern time with its offset, such as 2026-10-23T15:36:13-04:00.
- `posted_by` (text): Who signed and posted the filing.
- `registrant` (object): The registrant in full.
- `registrant_id` (number): The registrant's Senate ID: what 'Get a registrant' takes.
- `registrant_name` (text): The registrant: the lobbying firm, or the organization lobbying for itself.
- `specific_issues` (list): What was lobbied on, in the filer's words: bills, rules and programs.
- `termination_date` (text): When the registrant stopped lobbying for the client, on a termination.

**Example output**

```json
{
  "activities": [
    {
      "description": "Federal appropriations and grant funding for drinking water supply infrastructure, including a FY2027 Congressionally Directed Spending / Community Project Funding request of $2,393,000 through the U.S. Army Corps of Engineers Environmental Infrastructure program.",
      "foreign_entity_issues": null,
      "government_entities": [
        "HOUSE OF REPRESENTATIVES",
        "SENATE"
      ],
      "issue_area": "Budget/Appropriations",
      "issue_code": "BUD",
      "lobbyists": [
        {
          "covered_position": "Associate Staff Member at House Committee on Appropriations Legislative Director for Rep. Vic Fazio, 1987 1993",
          "lobbyist_id": 144733,
          "name": "WILLIAM ROGER GWINN",
          "new": false
        },
        {
          "covered_position": "Counsel, Office of Rep. Robert Matsui, 2/1991-10/1994",
          "lobbyist_id": 150448,
          "name": "GEORGE MICHAEL MILLER",
          "new": false
        }
      ]
    },
    {
      "description": "Federal programs and funding for raw water transmission and drinking water supply infrastructure.",
      "foreign_entity_issues": null,
      "government_entities": [
        "HOUSE OF REPRESENTATIVES",
        "SENATE"
      ],
      "issue_area": "Environment/Superfund",
      "issue_code": "ENV",
      "lobbyists": [
        {
          "covered_position": null,
          "lobbyist_id": 144733,
          "name": "WILLIAM ROGER GWINN",
          "new": false
        }
      ]
    }
  ],
  "affiliated_organizations": [],
  "amount": 20000.0,
  "client": {
    "client_id": 75728,
    "country": "US",
    "country_name": "United States of America",
    "description": "Public gov agency that provides water/wastewater services to Wilmington/New Hanover Co. NC",
    "effective_date": "2025-08-19",
    "is_government_entity": null,
    "name": "CAPE FEAR PUBLIC UTILITY AUTHORITY",
    "ppb_country": "US",
    "ppb_state": "NC",
    "state": "NC",
    "state_name": "North Carolina"
  },
  "client_id": 75728,
  "client_name": "CAPE FEAR PUBLIC UTILITY AUTHORITY",
  "conviction_disclosures": [],
  "document_url": "https://lda.gov/filings/public/filing/5feb9933-1ef3-43d3-9d42-a558a4ca11cf/print/",
  "expenses": null,
  "expenses_method": null,
  "filing_period": "fourth_quarter",
  "filing_period_name": "4th Quarter (Oct 1 to Dec 31)",
  "filing_type": "Q4",
  "filing_type_name": "4th Quarter Report",
  "filing_uuid": "5feb9933-1ef3-43d3-9d42-a558a4ca11cf",
  "filing_year": 2025,
  "foreign_entities": [],
  "government_entities": [
    "HOUSE OF REPRESENTATIVES",
    "SENATE"
  ],
  "income": 20000.0,
  "issue_areas": [
    "Budget/Appropriations",
    "Environment/Superfund"
  ],
  "issue_codes": [
    "BUD",
    "ENV"
  ],
  "lobbyists": [
    {
      "lobbyist_id": 144733,
      "name": "WILLIAM ROGER GWINN"
    },
    {
      "lobbyist_id": 150448,
      "name": "GEORGE MICHAEL MILLER"
    }
  ],
  "posted_at": "2026-10-23T15:36:13-04:00",
  "posted_by": "Laura Cosenzo",
  "registrant": {
    "address": "1901 PENNSYLVANIA AVENUE NW, SUITE 700",
    "city": "WASHINGTON",
    "contact_name": "LAURA COSENZO",
    "contact_telephone": "+1 202-331-8500",
    "country": "US",
    "country_name": "United States of America",
    "description": "Government Relations/Lobbying Firm",
    "house_registrant_id": 32589,
    "name": "THE FERGUSON GROUP",
    "registrant_id": 14451,
    "state": "DC",
    "state_name": "District of Columbia",
    "updated_at": "2026-10-23T16:11:54.892761-04:00",
    "zip": "20006"
  },
  "registrant_id": 14451,
  "registrant_name": "THE FERGUSON GROUP",
  "specific_issues": [
    "Federal appropriations and grant funding for drinking water supply infrastructure, including a FY2027 Congressionally Directed Spending / Community Project Funding request of $2,393,000 through the U.S. Army Corps of Engineers Environmental Infrastructure program.",
    "Federal programs and funding for raw water transmission and drinking water supply infrastructure."
  ],
  "termination_date": null
}
```

### Get a lobbyist

Get one lobbyist by their ID: their full name and the registrant they lobby for.

**Inputs**

- Lobbyist ID (`lobbyist_id`, text, required): The lobbyist's ID, from a search or a filing.

**Outputs**

- `first_name` (text): Their first name.
- `last_name` (text): Their last name.
- `lobbyist_id` (number): The lobbyist's ID: one per registrant they lobby for.
- `middle_name` (text): Their middle name or initial.
- `name` (text): Their name as filed: first, middle and last name and suffix.
- `nickname` (text): The name they go by, when given.
- `prefix` (text): Their prefix, such as MR. or DR.
- `registrant_id` (number): The registrant they lobby for.
- `registrant_name` (text): That registrant's name.
- `suffix` (text): Their suffix, such as JR or III.

**Example output**

```json
{
  "first_name": "WILLIAM",
  "last_name": "GWINN",
  "lobbyist_id": 144733,
  "middle_name": "ROGER",
  "name": "WILLIAM ROGER GWINN",
  "nickname": null,
  "prefix": "MR.",
  "registrant_id": 14451,
  "registrant_name": "THE FERGUSON GROUP",
  "suffix": null
}
```

### Get a registrant

Get one registrant by its ID: its name, description, address, contact and House ID.

**Inputs**

- Registrant ID (`registrant_id`, text, required): The registrant's Senate ID, from a search or a filing.

**Outputs**

- `address` (text): Its street address.
- `city` (text): Its city.
- `contact_name` (text): Whom to contact about its filings.
- `contact_telephone` (text): Their telephone number.
- `country` (text): Its country's two-letter code, such as US.
- `country_name` (text): Its country by name.
- `description` (text): What it does, in its own words.
- `house_registrant_id` (number): The ID the House Clerk gives it.
- `name` (text): Its name, such as AKIN GUMP STRAUSS HAUER & FELD.
- `registrant_id` (number): The registrant's Senate ID: what 'Get a registrant' takes.
- `state` (text): Its state's two-letter code, such as DC.
- `state_name` (text): Its state by name.
- `updated_at` (text): When its record last changed.
- `zip` (text): Its ZIP code.

**Example output**

```json
{
  "address": "2001 K St NW",
  "city": "WASHINGTON",
  "contact_name": "BRIAN POMPER",
  "contact_telephone": "+1 202-887-4000",
  "country": "US",
  "country_name": "United States of America",
  "description": "Law firm",
  "house_registrant_id": 31784,
  "name": "AKIN GUMP STRAUSS HAUER & FELD",
  "registrant_id": 682,
  "state": "DC",
  "state_name": "District of Columbia",
  "updated_at": "2026-07-30T23:00:42.376033-04:00",
  "zip": "20006"
}
```

### List lobbying codes

List one of the code lists filings use, such as the 79 lobbying issue areas (TAX for taxation), the filing types, the government entities lobbyists contact, or the kinds of contribution.

**Inputs**

- List (`code_list`, text, required): Which code list to read. One of: `filing_types` (Filing types), `issue_areas` (Issue areas), `government_entities` (Government entities), `countries`, `states` (US states and territories), `contribution_types` (Contribution types), `prefixes` (Name prefixes), `suffixes` (Name suffixes).

**Outputs**

- `code_list` (text): Which list this is, such as issue_areas.
- `code_list_name` (text): The list by name, such as Issue areas.
- `codes` (list): Every entry of the list.
- `count` (number): How many entries the list has.

**Example output**

```json
{
  "code_list": "issue_areas",
  "code_list_name": "Issue areas",
  "codes": [
    {
      "code": "ACC",
      "name": "Accounting"
    },
    {
      "code": "BUD",
      "name": "Budget/Appropriations"
    },
    {
      "code": "TAX",
      "name": "Taxation/Internal Revenue Code"
    }
  ],
  "count": 3
}
```

### Search clients

Find the clients registrants lobby for, by name, registrant, state and country. A client has one record for each registrant it hires, each with its own ID and the date that engagement began.

**Inputs**

- Name (`name`, text): Words in the client's name, in any case.
- Registrant (`registrant`, text): Only clients of this registrant: its name or part of it, or its ID.
- State (`state`, text): Only those in this US state or territory.
- Country (`country`, text): Only those in this country.
- Order (`sort`, text): By name, by default, or most recent engagement or newest first. One of: `name` (Name, A to Z), `effective` (Most recent engagement first), `newest` (Newest clients first). Default: `name`.
- Page (`page`, number): Which page of 25 results to return, from 1. From 1 to 100000. Default: `1`.

**Outputs**

- `clients` (list): The clients found: one record for each registrant a client hires.
- `count` (number): How many different ones are on this page (25 at most).
- `more_available` (true/false): True when there is another page: raise 'Page' by one to read it.
- `page` (number): The page these are, from 1.
- `total` (number): LDA's count of matches. A search on a filing's parts (its issues, lobbyists or contributions) counts it once for each part that matches, so this can be more than there are.

**Example output**

```json
{
  "clients": [
    {
      "client_id": 64261,
      "country": "US",
      "country_name": "United States of America",
      "description": "Multinational Technology Conglomerate.",
      "effective_date": "2025-02-02",
      "is_government_entity": null,
      "name": "MICROSOFT CORPORATION",
      "ppb_country": "US",
      "ppb_state": "DC",
      "registrant_id": 682,
      "registrant_name": "AKIN GUMP STRAUSS HAUER & FELD",
      "state": "DC",
      "state_name": "District of Columbia"
    }
  ],
  "count": 1,
  "more_available": true,
  "page": 1,
  "total": 113
}
```

### Search contribution reports

Find the twice yearly reports (LD-203) of political contributions by registrants and their lobbyists, by registrant, lobbyist, honoree, payee, year, kind of contribution and date, newest first. Each comes with every contribution it lists: who gave, to whom, for whom, how much and when.

**Inputs**

- Registrant (`registrant`, text): The lobbying firm, or the organization lobbying for itself: its name or part of it, in any case, or its ID from 'Search registrants'. Leave empty for every registrant.
- Lobbyist (`lobbyist`, text): A lobbyist: their name or part of it, such as their last name, or their ID from 'Search lobbyists'. Leave empty for every lobbyist.
- Honoree (`honoree`, text): Only reports with a contribution for or honoring this person or group, such as a member of Congress: a name or part of it.
- Payee (`payee`, text): Only reports with a contribution paid to this committee or group: a name or part of it.
- Contributor (`contributor`, text): Only reports with a contribution from this contributor, such as a PAC's name. A lobbyist's own gifts read SELF.
- Filing year (`filing_year`, number): Only reports for this year. Reports began in 2008. From 2008 to 2027.
- Filing period (`filing_period`, text): Only reports for this half year. One of: `mid_year` (Mid-year (Jan 1 to Jun 30)), `year_end` (Year-end (Jul 1 to Dec 31)).
- Report type (`filing_type`, text): Only reports, or only amendments, for a half year. One of: `MM` (Mid-year report), `MA` (Mid-year amendment), `YY` (Year-end report), `YA` (Year-end amendment).
- Kind of contribution (`contribution_type`, text): Only reports with this kind of contribution, such as FECA (to a candidate, PAC or party) or Honorary Expenses.
- Contributed on or after (`contributed_after`, date): Only reports with a contribution made on this date or later.
- Contributed on or before (`contributed_before`, date): Only reports with a contribution made on this date or earlier.
- Posted on or after (`posted_after`, date): Only reports posted on this date or later.
- Posted on or before (`posted_before`, date): Only reports posted on this date or earlier.
- Organizations' reports only (`organizations_only`, true/false): Leave out the reports lobbyists file for themselves, keeping the registrants' own. Default: `false`.
- Order (`sort`, text): Newest posted first, by default, or oldest first. One of: `newest` (Newest posted first), `oldest` (Oldest posted first). Default: `newest`.
- Page (`page`, number): Which page of 25 results to return, from 1. From 1 to 100000. Default: `1`.

**Outputs**

- `count` (number): How many different ones are on this page (25 at most).
- `more_available` (true/false): True when there is another page: raise 'Page' by one to read it.
- `page` (number): The page these are, from 1.
- `reports` (list): The contribution reports found, newest posted first unless sorted.
- `total` (number): LDA's count of matches. A search on a filing's parts (its issues, lobbyists or contributions) counts it once for each part that matches, so this can be more than there are.

**Example output**

```json
{
  "count": 2,
  "more_available": true,
  "page": 1,
  "reports": [
    {
      "contribution_count": 2,
      "contribution_total": 10000.0,
      "contributions": [
        {
          "amount": 5000.0,
          "contributor": "SELF",
          "date": "2025-07-21",
          "honoree": "Lindsey Graham",
          "payee": "TEAM GRAHAM, INC.",
          "type": "feca",
          "type_name": "FECA"
        },
        {
          "amount": 5000.0,
          "contributor": "SELF",
          "date": "2025-07-21",
          "honoree": "Lindsey Graham",
          "payee": "FUND FOR AMERICA'S FUTURE",
          "type": "feca",
          "type_name": "FECA"
        }
      ],
      "document_url": "https://lda.gov/filings/public/contribution/f4722cff-125e-43f1-82f7-9bb72147c426/print/",
      "filer_type": "organization",
      "filing_period": "year_end",
      "filing_period_name": "Year-End (July 1 to Dec 31)",
      "filing_type": "YA",
      "filing_type_name": "Year-End Amendment",
      "filing_uuid": "f4722cff-125e-43f1-82f7-9bb72147c426",
      "filing_year": 2025,
      "lobbyist_id": null,
      "lobbyist_name": null,
      "no_contributions": false,
      "pacs": [
        "American Dental Political Action Committee"
      ],
      "posted_at": "2026-08-11T15:16:57-04:00",
      "registrant_id": 2228,
      "registrant_name": "AMERICAN DENTAL ASSOCIATION"
    },
    {
      "contribution_count": 0,
      "contribution_total": 0,
      "contributions": [],
      "document_url": "https://lda.gov/filings/public/contribution/ca7003bf-47ea-48a8-902a-ab913906b453/print/",
      "filer_type": "lobbyist",
      "filing_period": "year_end",
      "filing_period_name": "Year-End (July 1 to Dec 31)",
      "filing_type": "YY",
      "filing_type_name": "Year-End Report",
      "filing_uuid": "ca7003bf-47ea-48a8-902a-ab913906b453",
      "filing_year": 2026,
      "lobbyist_id": 41374,
      "lobbyist_name": "ERIC J ELLMAN",
      "no_contributions": true,
      "pacs": [],
      "posted_at": "2026-10-23T16:11:19-04:00",
      "registrant_id": 4788,
      "registrant_name": "CONSUMER DATA INDUSTRY ASSOCIATION"
    }
  ],
  "total": 22756
}
```

### Search lobbying filings

Find registrations and quarterly lobbying reports (LD-1 and LD-2) by registrant, client or lobbyist, year, period, type, date posted, amount and the words of the issues lobbied on, newest first. Each comes with the registrant, the client, the amount reported, the issue areas, the lobbyists and the parts of the government contacted.

**Inputs**

- Registrant (`registrant`, text): The lobbying firm, or the organization lobbying for itself: its name or part of it, in any case, or its ID from 'Search registrants'. Leave empty for every registrant.
- Client (`client`, text): Whom the lobbying was for: a name or part of it, in any case, or a client ID from 'Search clients'. Leave empty for every client.
- Lobbyist (`lobbyist`, text): A lobbyist: their name or part of it, such as their last name, or their ID from 'Search lobbyists'. Leave empty for every lobbyist.
- Filing year (`filing_year`, number): Only filings for this year. LDA holds filings from 1999. From 1999 to 2027.
- Filing period (`filing_period`, text): Only filings for this period. Quarters began in 2008; before that, filings covered half years. One of: `first_quarter` (1st quarter (Jan 1 to Mar 31)), `second_quarter` (2nd quarter (Apr 1 to Jun 30)), `third_quarter` (3rd quarter (Jul 1 to Sep 30)), `fourth_quarter` (4th quarter (Oct 1 to Dec 31)), `mid_year` (Mid-year (Jan 1 to Jun 30)), `year_end` (Year-end (Jul 1 to Dec 31)).
- Filing type (`filing_type`, text): Only one type of filing, such as Registration or 3rd Quarter Report. Leave empty for every type.
- Posted on or after (`posted_after`, date): Only filings posted on this date or later.
- Posted on or before (`posted_before`, date): Only filings posted on this date or earlier.
- Specific issues contain (`issue_text`, text): Words in what was lobbied on, such as a bill number or a subject. Words match any of them; put a phrase in double quotes, join alternatives with OR, and put a minus before words to leave out.
- Amount at least (`amount_min`, number): Only filings reporting at least this many dollars of income or expenses. At least 0.
- Amount at most (`amount_max`, number): Only filings reporting at most this many dollars. At least 0.
- Client state (`client_state`, text): Only filings for clients in this US state or territory.
- Client country (`client_country`, text): Only filings for clients in this country.
- Former government job contains (`covered_position`, text): Only filings naming a lobbyist who disclosed a government job matching these words, such as "Finance Committee". The same syntax as 'Specific issues contain'.
- Foreign entity (`foreign_entity`, text): Only filings naming a foreign entity that owns, controls or funds the client, by name or part of it.
- Order (`sort`, text): Newest posted first, by default, or oldest first. One of: `newest` (Newest posted first), `oldest` (Oldest posted first). Default: `newest`.
- Page (`page`, number): Which page of 25 results to return, from 1. From 1 to 100000. Default: `1`.

**Outputs**

- `count` (number): How many different ones are on this page (25 at most).
- `filings` (list): The filings found, newest posted first unless sorted.
- `more_available` (true/false): True when there is another page: raise 'Page' by one to read it.
- `page` (number): The page these are, from 1.
- `total` (number): LDA's count of matches. A search on a filing's parts (its issues, lobbyists or contributions) counts it once for each part that matches, so this can be more than there are.

**Example output**

```json
{
  "count": 2,
  "filings": [
    {
      "amount": 20000.0,
      "client_id": 75728,
      "client_name": "CAPE FEAR PUBLIC UTILITY AUTHORITY",
      "document_url": "https://lda.gov/filings/public/filing/5feb9933-1ef3-43d3-9d42-a558a4ca11cf/print/",
      "expenses": null,
      "filing_period": "fourth_quarter",
      "filing_period_name": "4th Quarter (Oct 1 to Dec 31)",
      "filing_type": "Q4",
      "filing_type_name": "4th Quarter Report",
      "filing_uuid": "5feb9933-1ef3-43d3-9d42-a558a4ca11cf",
      "filing_year": 2025,
      "government_entities": [
        "HOUSE OF REPRESENTATIVES",
        "SENATE"
      ],
      "income": 20000.0,
      "issue_areas": [
        "Budget/Appropriations",
        "Environment/Superfund"
      ],
      "issue_codes": [
        "BUD",
        "ENV"
      ],
      "lobbyists": [
        {
          "lobbyist_id": 144733,
          "name": "WILLIAM ROGER GWINN"
        },
        {
          "lobbyist_id": 150448,
          "name": "GEORGE MICHAEL MILLER"
        }
      ],
      "posted_at": "2026-10-23T15:36:13-04:00",
      "registrant_id": 14451,
      "registrant_name": "THE FERGUSON GROUP",
      "specific_issues": [
        "Federal appropriations and grant funding for drinking water supply infrastructure, including a FY2027 Congressionally Directed Spending / Community Project Funding request of $2,393,000 through the U.S. Army Corps of Engineers Environmental Infrastructure program.",
        "Federal programs and funding for raw water transmission and drinking water supply infrastructure."
      ]
    },
    {
      "amount": null,
      "client_id": 64008,
      "client_name": "RUBIN TURNBULL AND ASSOCIATES OBO PENSKE TRUCK LEASING COMPANY, L.P.",
      "document_url": "https://lda.gov/filings/public/filing/b1b8d82e-0e2f-4fe3-bb82-30e216ebdab0/print/",
      "expenses": null,
      "filing_period": "first_quarter",
      "filing_period_name": "1st Quarter (Jan 1 to Mar 31)",
      "filing_type": "RR",
      "filing_type_name": "Registration",
      "filing_uuid": "b1b8d82e-0e2f-4fe3-bb82-30e216ebdab0",
      "filing_year": 2025,
      "government_entities": [],
      "income": null,
      "issue_areas": [
        "Trucking/Shipping"
      ],
      "issue_codes": [
        "TRU"
      ],
      "lobbyists": [
        {
          "lobbyist_id": 66998,
          "name": "MELISSA KUIPERS BLAKE"
        }
      ],
      "posted_at": "2025-02-05T12:26:23-05:00",
      "registrant_id": 7257,
      "registrant_name": "BROWNSTEIN HYATT FARBER SCHRECK, LLP",
      "specific_issues": [
        "Trucking industry related issues, generally; Environmental Protection Agency, N0x Emissions related issues; Electric Vehicle related issues."
      ]
    }
  ],
  "more_available": true,
  "page": 1,
  "total": 109203
}
```

### Search lobbyists

Find lobbyists by name and registrant, newest first. A lobbyist has one record, with its own ID, for each registrant they lobby for.

**Inputs**

- Name (`name`, text): Words in the lobbyist's name, such as a last name or a first and last name.
- Registrant (`registrant`, text): Only lobbyists for this registrant: its name or part of it, or its ID.
- Page (`page`, number): Which page of 25 results to return, from 1. From 1 to 100000. Default: `1`.

**Outputs**

- `count` (number): How many different ones are on this page (25 at most).
- `lobbyists` (list): The lobbyists found, newest first: one record for each registrant they lobby for.
- `more_available` (true/false): True when there is another page: raise 'Page' by one to read it.
- `page` (number): The page these are, from 1.
- `total` (number): LDA's count of matches. A search on a filing's parts (its issues, lobbyists or contributions) counts it once for each part that matches, so this can be more than there are.

**Example output**

```json
{
  "count": 1,
  "lobbyists": [
    {
      "first_name": "WILLIAM",
      "last_name": "GWINN",
      "lobbyist_id": 144733,
      "middle_name": "ROGER",
      "name": "WILLIAM ROGER GWINN",
      "nickname": null,
      "prefix": "MR.",
      "registrant_id": 14451,
      "registrant_name": "THE FERGUSON GROUP",
      "suffix": null
    }
  ],
  "more_available": false,
  "page": 1,
  "total": 3
}
```

### Search registrants

Find registrants (the lobbying firms, and the organizations that lobby for themselves) by name, state, country and when their record last changed, with their ID, address and contact.

**Inputs**

- Name (`name`, text): Words in the registrant's name, in any case.
- State (`state`, text): Only those in this US state or territory.
- Country (`country`, text): Only those in this country.
- Updated on or after (`updated_after`, date): Only registrants whose record changed on this date or later.
- Updated on or before (`updated_before`, date): Only registrants whose record changed on this date or earlier.
- Order (`sort`, text): By name, by default, or by last update or newest. One of: `name` (Name, A to Z), `updated` (Most recently updated first), `newest` (Newest registrants first). Default: `name`.
- Page (`page`, number): Which page of 25 results to return, from 1. From 1 to 100000. Default: `1`.

**Outputs**

- `count` (number): How many different ones are on this page (25 at most).
- `more_available` (true/false): True when there is another page: raise 'Page' by one to read it.
- `page` (number): The page these are, from 1.
- `registrants` (list): The registrants found.
- `total` (number): LDA's count of matches. A search on a filing's parts (its issues, lobbyists or contributions) counts it once for each part that matches, so this can be more than there are.

**Example output**

```json
{
  "count": 1,
  "more_available": false,
  "page": 1,
  "registrants": [
    {
      "address": "2001 K St NW",
      "city": "WASHINGTON",
      "contact_name": "BRIAN POMPER",
      "contact_telephone": "+1 202-887-4000",
      "country": "US",
      "country_name": "United States of America",
      "description": "Law firm",
      "house_registrant_id": 31784,
      "name": "AKIN GUMP STRAUSS HAUER & FELD",
      "registrant_id": 682,
      "state": "DC",
      "state_name": "District of Columbia",
      "updated_at": "2026-07-30T23:00:42.376033-04:00",
      "zip": "20006"
    }
  ],
  "total": 1
}
```
