FEfec
legal

GET /v1/rulemaking/search/

Changed on

The Searchable Electronic Rulemaking System (SERS) lets you search all public documents associated with Federal Election Commission rulemakings (REGs), including draft Federal Register publications, open meeting agendas, comments submitted by the public, and hearing transcripts.

Request

  • Base URL
    https://api.open.fec.gov (the document declares no server; this is the origin it was published from)
  • Auth
    API key in header X-Api-Key and API key in query parameter api_key and API key in query parameter api_key
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

qstring

Search field to find documents containing a word or phrase in their text.

q_excludestring

Exclude documents containing this term

from_hitinteger

Get results starting from this index

hits_returnedinteger

Number of results to return. The default value is 30, with a maximum limit of 200 results per page

rm_nostring[]

Search a REG number to go directly to the REG and all associated documents. REG numbers are listed in a YYYY-PP format

rm_namestring[]

Search REG Name field to retrieve REG documents with specific words in their names.

rm_yearinteger

Search by REG documents by the year in which a rulemaking began

doc_category_idstring[]

Category of the rulemaking document

  • 1 - Open Meeting
  • 2 - Hearing
  • 3 - Agenda Document
  • 4 - Federal Register Document
  • 5 - Comments and Ex Parte Communications
  • 6 - Commencing Document"
  • 7 - Votes
  • 8 - Press & Public Guidance
doc_idinteger

Filter rulemakings by a specific document ID (doc_id). Returns only rulemakings that contain a document matching the given ID.

min_federal_registry_publish_datestring

Search for documents associated with a REG where the Federal Register published a REG document approved by the Commission on or after this date. Date must be formatted as MM/DD/YYYY or YYYY-MM-DD."

max_federal_registry_publish_datestring

Search for documents associated with a REG where the Federal Register published a REG document approved by the Commission on or before this date. Date must be formatted as MM/DD/YYYY or YYYY-MM-DD."

min_hearing_datestring

Search for documents associated with a REG where the Commission held a hearing on or after this date. Date must be formatted as MM/DD/YYYY or YYYY-MM-DD."

max_hearing_datestring

Search for documents associated with a REG where the Commission held a hearing on or before this date. Date must be formatted as MM/DD/YYYY or YYYY-MM-DD."

min_vote_datestring

Search for documents associated with a REG where the Commission voted on an agenda document on or after this date. Date must be formatted as MM/DD/YYYY or YYYY-MM-DD."

max_vote_datestring

Search for documents associated with a REG where the Commission voted on an agenda document on or after this date. Date must be formatted as MM/DD/YYYY or YYYY-MM-DD."

is_key_documentboolean

When set to true, only rulemakings with at least one key document are returned

is_open_for_commentboolean

When set to true, this flag returns rulemakings that are currently open for comment.

entity_namestring

Name of the entity related a specific rulemaking

entity_role_typestring[]

An "entity" is any individual or group that plays one of the following roles with respect to a REG. The different entity roles are:

  • 1 - Petitioner
  • 2 - Witness
  • 3 - Counsel
  • 4 - Officer/Representative
  • 5 - Commenter
filenamestring

Search documents by file name

sortstring

Sort rulemaking by rm_no or is_open_for_comment. Use - before a parameter name to sort in descending order. ex: -rm_no or -is_open_for_comment

q_proximitystring[]

This search identifies documents where the specified phrases appear near each other. The field supports both a single phrase or multiple phrases. For a single phrase, the maximum gap is applied between the words in the phrase. For multiple phrases, the maximum gap is applied between the phrases themselves.

max_gapsinteger

The maximum number of positions allowed between terms specified in q_proximity

proximity_preserve_orderboolean

When set to true, maintains the original order of phrases in q_proximity.

proximity_filter'after' | 'before'

Adds additional filters to the proximity search that provides options to specify positional constraints

proximity_filter_termstring

Specifies the term to which the proximity_filter option applies to and defines what must appear in relation to the q_proximity phrase

api_keystring

API key for https://api.data.gov. Get one at https://api.data.gov/signup.

Response

Rulemaking search results

Changes