# Highergov

HigherGov is a market intelligence platform providing comprehensive data on U.S. federal, state, and local government contracts and grants.

- **Category:** business intelligence
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 17
- **Triggers:** 0
- **Slug:** `HIGHERGOV`
- **Version:** 20260312_00

## Tools

### Get Agencies

**Slug:** `HIGHERGOV_GET_AGENCIES`

Retrieves government agency information from the HigherGov database with pagination support. Use this tool to: - List all federal agencies with details like name, abbreviation, type, and hierarchy - Search for a specific agency by its unique agency_key identifier - Navigate through paginated results of agencies (28,000+ agencies available) The response includes agency hierarchy levels (level_1 through level_7) showing parent-child relationships between agencies, along with pagination metadata for browsing through results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starting from 1 |
| `page_size` | integer | No | Number of items per page (max 100), defaults to 10 if not provided |
| `agency_key` | integer | No | Filter by specific HigherGov agency key to get details for a single agency |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contracts

**Slug:** `HIGHERGOV_GET_CONTRACTS`

Retrieve federal government contract data from HigherGov. Returns paginated list of contracts with details including awardees, agencies, amounts, dates, NAICS/PSC codes, and performance information. Supports filtering by date, search criteria, award ID, awardee, agency, industry codes, and more. Data updates daily by 2am for two days prior.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `award_id` | string | No | The government Award ID to filter by specific contract |
| `psc_code` | string | No | PSC (Product Service Code) to filter contracts |
| `page_size` | integer | No | Number of records per page (default: 10, max: 100) |
| `search_id` | string | No | HigherGov SearchID to filter contracts by saved search criteria |
| `naics_code` | string | No | NAICS code to filter contracts by industry classification |
| `awardee_key` | integer | No | HigherGov Awardee Key to filter contracts by awardee |
| `page_number` | integer | No | Page number for pagination, starting from 1 |
| `last_modified_date` | string | No | Filter by last modified date in YYYY-MM-DD format |
| `awarding_agency_key` | integer | No | HigherGov Awarding Agency key to filter by awarding agency |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contract Vehicles

**Slug:** `HIGHERGOV_GET_CONTRACT_VEHICLES`

Retrieve federal multi-award contract vehicles from HigherGov. Contract vehicles are pre-established contracting mechanisms that streamline procurement. Use this to list available vehicles with optional filtering by vehicle key and sorting by award date. Supports pagination with up to 100 records per page. Updated ad hoc as new awards are made.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ordering` | string | No | Sort field. Use 'award_date' for ascending or '-award_date' for descending order |
| `page_size` | string | No | Number of items per page (max 100). Must be a string. Default is '10' if not provided |
| `page_number` | integer | No | Page number for pagination, starting from 1 |
| `vehicle_key` | integer | No | HigherGov Vehicle key to filter by a specific vehicle |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Documents

**Slug:** `HIGHERGOV_GET_DOCUMENTS`

Retrieve document metadata and download URLs for files associated with government opportunities, contracts, and grants from HigherGov. **When to use:** After calling Get Opportunities, Get Contracts, or Get Grants, use this tool to fetch the actual documents (RFPs, amendments, attachments, etc.) associated with those records. **How to use:** 1. First call Get Opportunities, Get Contracts, or Get Grants 2. Extract the 'document_path' field from the response 3. Parse the 'related_key' parameter from that document_path URL 4. Pass that related_key to this tool to retrieve the documents **Important notes:** - Download URLs expire after 60 minutes; retrieve new URLs by calling this endpoint again - Some opportunities/contracts/grants may have no associated documents (returns empty results) - Results are paginated; use page and page_size parameters for large document sets

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (must be >= 1). Defaults to 1. |
| `grant_id` | integer | No | Filter documents by associated grant ID. Usually unnecessary as related_key already scopes to the grant. |
| `ordering` | string | No | Sort order for results. Use field name for ascending (e.g., 'created_at') or prefix with '-' for descending (e.g., '-created_at'). |
| `page_size` | integer | No | Number of documents per page (1-100). If not specified, uses API default (10). |
| `contract_id` | integer | No | Filter documents by associated contract ID. Usually unnecessary as related_key already scopes to the contract. |
| `document_id` | integer | No | Filter to a specific document by its unique ID. Rarely needed as related_key typically identifies the document set. |
| `related_key` | string | Yes | Required identifier to retrieve documents associated with an opportunity, contract, or grant. Extract this from the 'document_path' field returned by the Get Opportunities, Get Contracts, or Get Grants endpoints. The document_path URL contains the related_key parameter (e.g., 'related_key=396-5364'). |
| `opportunity_id` | integer | No | Filter documents by associated opportunity ID. Usually unnecessary as related_key already scopes to the opportunity. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Grant History

**Slug:** `HIGHERGOV_GET_GRANT_HISTORY`

Tool to fetch historical data on grants from the HigherGov API. REQUIRED: At least one filter parameter (award_id or last_modified_date) must be provided. Use cases: - Retrieve history for a specific grant by award_id - Retrieve grants modified since a specific date using last_modified_date - Paginate through results using page and page_size parameters

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be >= 1 |
| `award_id` | string | No | Grant award ID to filter a specific grant (e.g., 'EMK-2021-BR-042'). At least one of award_id or last_modified_date must be provided. |
| `page_size` | integer | No | Number of items per page (1-100). If omitted, uses default from app config |
| `last_modified_date` | string | No | Filter grants by last modified date in YYYY-MM-DD format. At least one of award_id or last_modified_date must be provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Grant Opportunities

**Slug:** `HIGHERGOV_GET_GRANT_OPPORTUNITIES`

Retrieve government grant and contract opportunities from HigherGov. Returns Federal contracts, SLED (State/Local) opportunities, grants, and SBIR opportunities with comprehensive details including agency info, dates, contacts, and award estimates. Use this when you need to: - Find government opportunities by date (posted_date or captured_date recommended) - Search for opportunities with specific keywords - Filter opportunities by agency, status, or other criteria - Get detailed opportunity information including contact details and documents REQUIRED: Must provide at least one filter (posted_date, captured_date, search_id, source_id, agency_key, opp_key, or version_key). For best results, use posted_date or captured_date with optional keyword filtering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be >= 1 |
| `status` | string ("open" | "closed") | No | Filter by opportunity status. Use 'open' for active opportunities accepting submissions, 'closed' for expired opportunities. |
| `keyword` | string | No | Search term to filter opportunities by title or description content. Use for finding opportunities related to specific topics, technologies, or services. |
| `opp_key` | integer | No | Get a specific opportunity by its unique key. Use when you have the exact opportunity identifier. |
| `agency_id` | integer | No | Legacy parameter: Filter by agency ID (automatically mapped to agency_key). Prefer using agency_key instead. |
| `page_size` | integer | No | Number of items per page (1-100). If omitted, uses default from app config |
| `search_id` | string | No | Saved HigherGov search ID to filter opportunities |
| `source_id` | integer | No | Advanced filter: Restrict results to a specific HigherGov data source identifier. Use only if you know the specific source ID. |
| `agency_key` | integer | No | Filter by agency identifier. Use this to find opportunities from a specific government agency. Preferred over legacy agency_id parameter. |
| `posted_date` | string | No | RECOMMENDED: Filter for opportunities originally posted on or after this date (YYYY-MM-DD format). Use this to find opportunities by their official posting date. Combine with keyword for targeted results. |
| `version_key` | integer | No | Get a specific version of an opportunity by its version key. Use for tracking opportunity modifications over time. |
| `captured_date` | string | No | RECOMMENDED: Filter for opportunities captured by HigherGov on or after this date (YYYY-MM-DD format). Use this to get recent opportunities. Combine with keyword for targeted results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Grant Programs

**Slug:** `HIGHERGOV_GET_GRANT_PROGRAMS`

Tool to retrieve information on grant programs. Use when you need to list available grant programs with pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starting from 1 |
| `page_size` | integer | No | Number of items per page, overrides default if provided |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NAICS Codes

**Slug:** `HIGHERGOV_GET_NAICS`

Retrieve NAICS (North American Industry Classification System) codes with detailed descriptions. Returns a paginated list of NAICS codes that can be filtered by code prefix and sorted. Useful for finding industry classifications, understanding NAICS hierarchies, and identifying relevant codes for business categorization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ordering` | string | No | Sort results by naics_code. Use 'naics_code' for ascending or '-naics_code' for descending order. |
| `page_size` | integer | No | Number of items per page (max 100). If not specified, API default is 10. |
| `naics_code` | string | No | Filter results by NAICS code. Can be a partial code to find all codes starting with that prefix (e.g., '541' for all professional services). |
| `page_number` | integer | No | Page number for pagination, starting from 1 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Opportunity History

**Slug:** `HIGHERGOV_GET_OPPORTUNITY_HISTORY`

Retrieve historical opportunity data from HigherGov with pagination support. This tool requires at least one identifying filter (captured_date, opp_key, version_key, search_id, posted_date, source_id, or agency_key). Most commonly used with captured_date to get all opportunities from a specific date, optionally filtered by source_type ('sam' or 'sled'). Returns paginated results with comprehensive opportunity details including title, description, agency, dates, contact information, and links to documents.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starting from 1 |
| `opp_key` | string | No | HigherGov opportunity key to filter history for a specific opportunity (satisfies required filter) |
| `page_size` | integer | No | Number of items per page; overrides default from app config |
| `search_id` | string | No | HigherGov saved search ID to filter opportunities (satisfies required filter) |
| `source_id` | string | No | Source identifier from the original opportunity source (satisfies required filter) |
| `agency_key` | integer | No | HigherGov agency key to filter opportunities by agency (satisfies required filter) |
| `posted_date` | string | No | Filter by opportunity posted date in YYYY-MM-DD format (satisfies required filter) |
| `source_type` | string | No | Filter by data source type (additional filter, can be combined with required filters) |
| `version_key` | string | No | Version key to filter a specific historical version of an opportunity (satisfies required filter) |
| `captured_date` | string | No | Historical snapshot date filter in YYYY-MM-DD format (satisfies required filter). Retrieves all opportunities captured on this date |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get People

**Slug:** `HIGHERGOV_GET_PEOPLE`

Retrieves contact information for federal and state/local government personnel from HigherGov. Returns detailed contact records including names, titles, emails, phone numbers, and affiliated agencies. Data is updated in real-time. Use this to find government contacts, especially when you have an email address or need to browse through personnel listings. Common use cases: - Find contact details for a specific government employee by email - Browse government personnel with pagination - Get the most recently updated contacts using ordering

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (1-based indexing). Use for pagination through large result sets. |
| `ordering` | string | No | Sort results by last_seen date. Use 'last_seen' for ascending or '-last_seen' for descending (most recent first). |
| `page_size` | integer | No | Number of records per page (1-100). Default is 10 if not specified. Maximum 100. |
| `contact_email` | string | No | Filter by exact contact email address to find a specific person. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Product and Service Codes

**Slug:** `HIGHERGOV_GET_PSC`

Tool to retrieve information on Product and Service Codes. Use when fetching PSC entries with optional pagination and filtering by code.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `psc_code` | string | No | Optional filter to return only PSC entries matching this specific code |
| `page_size` | integer | No | Number of items per page (integer, minimum 1, maximum 100) |
| `page_number` | integer | No | Page number within the paginated result set (integer, minimum 1) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Pursuits

**Slug:** `HIGHERGOV_GET_PURSUITS`

Tool to retrieve user-specific pursuits. Use when you need to fetch a user's pursuits with optional filtering by status and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starting from 1 |
| `status` | string | No | Filter pursuits by status (e.g., open, closed) |
| `opp_key` | integer | No | Filter by specific opportunity key for opportunities fallback |
| `user_id` | string | No | Filter pursuits by the user's unique identifier |
| `page_size` | integer | No | Number of items per page, overrides default if provided |
| `search_id` | string | No | Saved HigherGov search ID to use with the opportunities fallback |
| `source_id` | string | No | Filter by source opportunity ID (e.g., '12639524Q0038') |
| `agency_key` | integer | No | Filter by HigherGov agency_key for opportunities fallback |
| `posted_date` | string | No | Filter by posted date (YYYY-MM-DD) for opportunities fallback |
| `source_type` | string | No | Filter by data source type (e.g., 'sam') for fallback |
| `version_key` | integer | No | Filter by specific opportunity version key for opportunities fallback |
| `captured_date` | string | No | Filter opportunities captured on or after this date (YYYY-MM-DD) for fallback |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get SBIR Opportunities

**Slug:** `HIGHERGOV_GET_SBIR_OPPORTUNITIES`

Retrieve SBIR (Small Business Innovation Research) opportunities from HigherGov. SBIR is a U.S. government program that provides funding to small businesses for research and development with commercialization potential. This action retrieves SBIR opportunities from federal agencies. By default, retrieves opportunities captured since 2024-01-01. Use filters to narrow results by specific dates, agencies, or opportunity identifiers. Supports pagination for large result sets. Key use cases: - Find recent SBIR opportunities for a specific federal agency - Track SBIR opportunities by capture/posting dates - Retrieve details for specific SBIR opportunities by ID - Monitor new SBIR opportunities added to the system Note: At least one filter parameter (captured_date, posted_date, search_id, source_id, agency_key, opp_key, or version_key) is required by the API. The action provides captured_date with a sensible default.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `opp_key` | string | No | Filter by specific HigherGov opportunity key (unique identifier) |
| `ordering` | string | No | Sort results by field. Prefix with '-' for descending. Options: captured_date, due_date, posted_date |
| `page_size` | string | No | Number of records per page (max 100, default 10). Must be provided as string. |
| `search_id` | string | No | HigherGov search ID to apply saved search filters |
| `source_id` | string | No | Source opportunity ID from the original source system |
| `agency_key` | integer | No | Filter by HigherGov agency key (unique identifier for the issuing agency) |
| `page_number` | integer | No | Page number for pagination (starts at 1). If not provided, defaults to first page. |
| `posted_date` | string | No | Filter opportunities posted by agency on this specific date (YYYY-MM-DD format) |
| `version_key` | string | No | Filter by specific HigherGov opportunity version key |
| `captured_date` | string | No | Filter opportunities captured/added to HigherGov on or after this date (YYYY-MM-DD format). Defaults to 2024-01-01 if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get SLED Contract Opportunities

**Slug:** `HIGHERGOV_GET_SLED_CONTRACT_OPPORTUNITIES`

Tool to retrieve state and local (SLED) contract opportunities. Uses the general Opportunity endpoint with optional filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `opp_key` | string | No | Filter by specific opportunity key |
| `ordering` | string | No | Sort results by field. Prefix with '-' for descending order. Available: 'captured_date', 'due_date', 'posted_date' |
| `page_size` | string | No | Number of items per page (default: 10, max: 100) |
| `search_id` | string | No | Pre-built HigherGov search identifier to filter opportunities |
| `source_id` | string | No | Filter by original source opportunity identifier |
| `agency_key` | integer | No | Filter by issuing agency key |
| `page_number` | integer | No | Page number for pagination, starting at 1 |
| `posted_date` | string | No | Filter opportunities posted on this date (YYYY-MM-DD). Date the opportunity was posted by the agency. |
| `source_type` | string | No | Filter by data source type. Use 'sled' for State and Local opportunities. Other values: 'sam' (federal SAM.gov), 'dibbs' (Defense DIBBS), 'sbir' (SBIR programs), 'grant' (Federal grants) |
| `version_key` | string | No | Filter by specific opportunity version key |
| `captured_date` | string | No | Filter opportunities captured on or after this date (YYYY-MM-DD). Defaults to 2024-01-01 to ensure at least one filter is active (required by API). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subcontract Awards

**Slug:** `HIGHERGOV_GET_SUBCONTRACT_AWARDS`

Retrieves federal subcontract award data from HigherGov. Returns paginated subcontract records with details about subcontract recipients, amounts, prime contracts, and awarding agencies. **Important**: At least one filter parameter (last_modified_date or search_id) is required by the API. Use this when you need to: - Find subcontracts modified on a specific date - List subcontracts from a saved HigherGov search - Access detailed subcontract award information including recipient details and prime contract relationships Data is updated weekly. Use the last_modified_date field to track updates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starts at 1) |
| `page_size` | integer | No | Number of records per page (1-100, default: 10) |
| `search_id` | string | No | Apply a HigherGov saved search ID to filter results. At least one filter parameter is required by the API. |
| `last_modified_date` | string | No | Filter by records last modified on this date (YYYY-MM-DD format). At least one filter parameter is required by the API. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subgrant Awards

**Slug:** `HIGHERGOV_GET_SUBGRANT_AWARDS`

Retrieves federal subgrant award data from HigherGov. Returns paginated subgrant records with details about subgrant recipients, funding amounts, associated prime grants, and program information. **Important**: At least one filter parameter (last_modified_date or search_id) is required by the API. Use this when you need to: - Find subgrant awards modified on a specific date - List subgrant awards from a saved HigherGov search - Access detailed subgrant award information including recipient details and prime grant relationships Data is updated regularly. Use the last_modified_date field to track updates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, must be >= 1 |
| `state` | string | No | Filter by recipient state (2-letter code) |
| `award_id` | string | No | Filter by associated prime grant award ID (string, e.g., B-23-CP-NJ-1004) |
| `page_size` | integer | No | Number of items per page (1-100), overrides default if provided |
| `search_id` | string | No | Apply a HigherGov saved search ID to filter results. At least one filter parameter (last_modified_date or search_id) is required by the API. |
| `fiscal_year` | integer | No | Filter by fiscal year |
| `subgrant_id` | integer | No | Filter by unique subgrant ID |
| `recipient_name` | string | No | Filter by recipient name |
| `subgrant_number` | string | No | Filter by subgrant number |
| `last_modified_date` | string | No | Filter by records last modified on this date (YYYY-MM-DD format). At least one filter parameter (last_modified_date or search_id) is required by the API. |
| `cfda_program_number` | string | No | Filter by CFDA program number (e.g., 14.251) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |