Government Data

Highergov

Learn how to use Highergov with Composio

Overview

SLUG: HIGHERGOV

Description

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

Authentication Details

generic_api_key
stringRequired

Connecting to Highergov

Create an auth config

Use the dashboard to create an auth config for the Highergov toolkit. This allows you to connect multiple Highergov accounts to Composio for agents to use.

1

Select App

Navigate to Highergov.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Highergov Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4highergov_auth_config_id = "ac_YOUR_HIGHERGOV_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Highergov for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, highergov_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Highergov toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["HIGHERGOV"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Get Agencies

Description

Tool to retrieve agencies information. Use when you need to list agencies with pagination.

Action Parameters

page
integerDefaults to 1
page_size
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Award History

Description

Tool to retrieve award history. Use when you need paginated historical award data.

Action Parameters

last_modified_date
string
page
integerDefaults to 1
page_size
integer
search_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Contract History

Description

Tool to retrieve contract history. Use when you need paginated historical data for a specific contract (via award_id/contract_id) or across contracts using last_modified_date.

Action Parameters

award_id
string
contract_id
string
last_modified_date
string
page
integerDefaults to 1
page_size
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Contract IDVs

Description

Tool to retrieve Indefinite Delivery Vehicle (IDV) contract records via the HigherGov Contracts endpoint. Use when you need to list IDVs with pagination, optionally leveraging a saved search_id that filters to IDVs.

Action Parameters

last_modified_date
string
page
integerDefaults to 1
page_size
integer
search_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Contracts

Description

Tool to retrieve federal contract data. Use when you need to list contracts with optional filters like last_modified_date or search_id.

Action Parameters

last_modified_date
string
page
integerDefaults to 1
page_size
integer
search_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Contract Vehicles

Description

Tool to retrieve contract vehicles. Use when you need to list contract vehicles with pagination.

Action Parameters

page
integerDefaults to 1
page_size
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Defense Programs

Description

Tool to retrieve defense programs information. Use when you need to list defense programs with pagination.

Action Parameters

page
integerDefaults to 1
page_size
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get DLA Contract Opportunities

Description

Tool to retrieve DLA contract opportunities. Use when needing paginated DLA procurement listings.

Action Parameters

agency_key
integer
captured_date
string
opp_key
string
page
integerDefaults to 1
page_size
integerDefaults to 10
posted_date
string
search_id
string
source_id
integer
version_key
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Documents

Description

Tool to fetch document metadata from HigherGov. Use when needing to retrieve documents associated with contracts, grants, or opportunities.

Action Parameters

contract_id
integer
document_id
integer
grant_id
integer
opportunity_id
integer
ordering
string
page
integerDefaults to 1
page_size
integer
related_key
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Grant History

Description

Tool to fetch historical data on grants. Use when you need paginated historical data for a specific grant (via award_id) or across grants using last_modified_date.

Action Parameters

award_id
string
last_modified_date
string
page
integerDefaults to 1
page_size
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Grant Opportunities

Description

Tool to retrieve information on grant opportunities. Use when you need a paginated list of grants filtered by keyword, agency, or status.

Action Parameters

agency_id
integer
agency_key
integer
captured_date
string
keyword
string
opp_key
integer
page
integerDefaults to 1
page_size
integer
posted_date
string
search_id
string
source_id
integer
status
string
version_key
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Grant Programs

Description

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

Action Parameters

page
integerDefaults to 1
page_size
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get NAICS Codes

Description

Tool to retrieve NAICS codes. Use when you need a pagitated list of NAICS codes, optionally filtered by code or title.

Action Parameters

code
string
page
integerDefaults to 1
page_size
integer
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Opportunities

Description

Tool to retrieve opportunity data. Use when you need a paginated list of opportunities filtered by search ID, date, or source type.

Action Parameters

captured_date
string
page
integerDefaults to 1
page_size
integer
search_id
string
source_type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Opportunity History

Description

Tool to retrieve opportunity history. Use when you need paginated historical data for a specific opportunity or across the dataset using captured_date.

Action Parameters

captured_date
string
opp_key
string
page
integerDefaults to 1
page_size
integer
source_type
string
version_key
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get People

Description

Tool to retrieve information on people related to government contracts and grants. Use when you need to search or filter individuals by name, organization, or role.

Action Parameters

ordering
string
organization
string
page
integerDefaults to 1
page_size
integer
person_id
integer
role
string
search
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Prime Contract Awards

Description

Tool to retrieve prime contract awards. Use when you need a paginated list of prime contract awards optionally filtered by last modified date or saved search ID.

Action Parameters

last_modified_date
string
page
integerDefaults to 1
page_size
integer
search_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Prime Grant Awards

Description

Tool to retrieve information on prime grant awards. Use when you need a paginated list of awarded federal grants.

Action Parameters

agency_id
integer
fiscal_year
integer
grant_id
integer
keyword
string
last_modified_date
string
page
integerDefaults to 1
page_size
integer
program_number
string
recipient_name
string
search_id
string
state
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Programs

Description

Tool to retrieve a list of government programs and categories. Use when exploring available programs with pagination.

Action Parameters

page
integerDefaults to 1
page_size
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Product and Service Codes

Description

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

Action Parameters

code
string
page
integerDefaults to 1
page_size
integerDefaults to 10

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Pursuits

Description

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

Action Parameters

agency_key
integer
captured_date
string
opp_key
integer
page
integerDefaults to 1
page_size
integer
posted_date
string
search_id
string
source_id
integer
source_type
string
status
string
user_id
string
version_key
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get SBIR Opportunities

Description

Tool to retrieve SBIR (Small Business Innovation Research) opportunities. Use when you need to list SBIR opportunities with optional filters and pagination.

Action Parameters

agency
string
agency_key
integer
captured_date
string
close_date_from
string
close_date_to
string
open_date_from
string
open_date_to
string
opp_key
string
page
integerDefaults to 1
page_size
integer
posted_date
string
topic
string
version_key
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get SLED Contract Opportunities

Description

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

Action Parameters

agency_key
integer
captured_date
string
opp_key
string
page
integerDefaults to 1
page_size
integerDefaults to 10
posted_date
string
search_id
string
source_id
integer
source_type
string
version_key
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Subcontract Awards

Description

Tool to retrieve subcontract awards. Use when you need to list subcontract awards with optional filters such as date range or prime award PIID.

Action Parameters

award_date_end
string
award_date_start
string
award_id
string
last_modified_date
string
page
integerDefaults to 1
page_size
integer
prime_award_piid
string
search_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Subgrant Awards

Description

Tool to retrieve subgrant awards information. Use when you need to list subgrant awards with optional filters such as recipient name, fiscal year, or program.

Action Parameters

award_id
string
cfda_program_number
string
fiscal_year
integer
last_modified_date
string
page
integerDefaults to 1
page_size
integer
recipient_name
string
search_id
string
state
string
subgrant_id
integer
subgrant_number
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Task Orders

Description

Tool to retrieve task order data. Use when you need to list task orders associated with contracts.

Action Parameters

page
integerDefaults to 1
page_size
integer
parent_award_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Tech Programs

Description

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

Action Parameters

page
integerDefaults to 1
page_size
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired