{
  "openapi": "3.0.1",
  "info": {
    "title": "Government Contracts API - Federal, SLED Bids, Awards, Grants",
    "description": "Government contracts and grants data from the HigherGov API: federal and state and local (SLED) bid opportunities updated every 30 minutes, SAM.gov, DIBBS, SBIR and grant solicitations, federal contract, IDV and grant awards, subcontracts and contractors by UEI, CAGE or NAICS. Bring your own key.",
    "version": "0.1",
    "x-build-id": "qnGRTUk6zpXNTfdUr"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nabeelbaghoor~government-contracts-grants-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nabeelbaghoor-government-contracts-grants-api",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/nabeelbaghoor~government-contracts-grants-api/runs": {
      "post": {
        "operationId": "runs-sync-nabeelbaghoor-government-contracts-grants-api",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/nabeelbaghoor~government-contracts-grants-api/run-sync": {
      "post": {
        "operationId": "run-sync-nabeelbaghoor-government-contracts-grants-api",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "What to get",
            "enum": [
              "opportunities",
              "contracts",
              "idvs",
              "grants",
              "slContracts",
              "subcontracts",
              "subgrants",
              "awardees",
              "agencies"
            ],
            "type": "string",
            "description": "Opportunities reads open and past federal contract (SAM.gov), DIBBS, SBIR, grant and state and local (SLED) solicitations, updated about every 30 minutes. The award modes read federal prime contracts, IDVs (IDIQs, GWACs, BPAs, schedules), grants, subcontracts and subgrants, plus state and local contract awards. Awardees reads SAM registered contractors; Agencies looks up agency keys for the agency filters.",
            "default": "opportunities"
          },
          "searchId": {
            "title": "HigherGov SearchID or saved search URL",
            "type": "string",
            "description": "Opportunities, Federal contract awards, Federal grant awards and State and local contract awards. Build a search on highergov.com (keywords, agency, NAICS, PSC, set aside, state, value range and more), save it, and paste the searchID from its URL or the whole URL. HigherGov applies the saved search fields its API supports."
          },
          "keyword": {
            "title": "Keyword (state and local awards)",
            "type": "string",
            "description": "State and local contract awards only. Free text search across state and local contract awards, such as cybersecurity or road maintenance."
          },
          "sourceType": {
            "title": "Opportunity source",
            "enum": [
              "sam",
              "dibbs",
              "sbir",
              "grant",
              "sled"
            ],
            "type": "string",
            "description": "Opportunities only. Limit to one source: SAM.gov federal contracts, DIBBS (DLA) solicitations, SBIR and STTR topics, federal grants, or state and local (SLED) bids. Leave empty for all."
          },
          "capturedDate": {
            "title": "Captured date",
            "type": "string",
            "description": "Opportunities, Federal contract awards and State and local contract awards. The date HigherGov added the record (for awards, captured the last amendment), YYYY-MM-DD. HigherGov recommends it to pull only what is new since your last run."
          },
          "postedDate": {
            "title": "Posted date",
            "type": "string",
            "description": "Opportunities only. The date the agency posted the opportunity, YYYY-MM-DD."
          },
          "lastModifiedDate": {
            "title": "Last modified date",
            "type": "string",
            "description": "Federal contract, IDV and grant awards, subcontracts and subgrants. The award's last modified date, YYYY-MM-DD; HigherGov's update check field for syncing awards."
          },
          "startDate": {
            "title": "Award start date",
            "type": "string",
            "description": "State and local contract awards only. Earliest start date for the award, YYYY-MM-DD."
          },
          "endDate": {
            "title": "Award end date",
            "type": "string",
            "description": "State and local contract awards only. Latest end date for the award, YYYY-MM-DD."
          },
          "registrationLastUpdateDate": {
            "title": "SAM registration updated",
            "type": "string",
            "description": "Awardees only. The date the awardee last updated its SAM registration, YYYY-MM-DD."
          },
          "agencyKey": {
            "title": "Agency key",
            "minimum": 1,
            "type": "integer",
            "description": "Opportunities and Agencies: agency_key. Award modes: the awarding agency key. A whole number HigherGov shows on the agency page; run the Agencies mode to look keys up."
          },
          "fundingAgencyKey": {
            "title": "Funding agency key",
            "minimum": 1,
            "type": "integer",
            "description": "Federal contract, IDV and grant awards, subcontracts and subgrants. The HigherGov key of the agency that funds the award."
          },
          "awardeeKey": {
            "title": "Awardee key",
            "minimum": 1,
            "type": "integer",
            "description": "Federal contract, IDV and grant awards, subcontracts and subgrants. The HigherGov awardee key of the recipient."
          },
          "awardeeKeyParent": {
            "title": "Parent awardee key",
            "minimum": 1,
            "type": "integer",
            "description": "Award modes and Awardees. The HigherGov awardee key at the parent company level, to get every subsidiary's awards or registrations."
          },
          "vehicleKey": {
            "title": "Contract vehicle key",
            "minimum": 1,
            "type": "integer",
            "description": "Federal contract and IDV awards. The HigherGov key of a contract vehicle such as a GWAC or schedule."
          },
          "awardeeUei": {
            "title": "Awardee UEI",
            "type": "string",
            "description": "Award modes: the recipient's 12 character SAM Unique Entity ID. Awardees: look up one registration by UEI."
          },
          "awardeeUeiParent": {
            "title": "Parent awardee UEI",
            "type": "string",
            "description": "Federal contract, IDV and grant awards, subcontracts and subgrants. The parent company UEI."
          },
          "cageCode": {
            "title": "CAGE code",
            "type": "string",
            "description": "Awardees only. The 5 character CAGE code."
          },
          "awardId": {
            "title": "Award ID",
            "type": "string",
            "description": "Federal contract, IDV and grant awards. The government award ID (PIID or FAIN)."
          },
          "parentAwardId": {
            "title": "Parent award ID",
            "type": "string",
            "description": "Federal contract and IDV awards. The award ID of the parent IDV, to list its task and delivery orders."
          },
          "naicsCode": {
            "title": "NAICS code",
            "type": "string",
            "description": "Federal contract and IDV awards: the award NAICS code. Awardees: the primary registered NAICS code. For example 541512."
          },
          "pscCode": {
            "title": "PSC code",
            "type": "string",
            "description": "Federal contract and IDV awards. The product and service code, such as D302."
          },
          "cfdaProgramNumber": {
            "title": "Assistance listing (CFDA) number",
            "type": "string",
            "description": "Federal grant awards only. The grant program number, such as 93.837."
          },
          "oppKey": {
            "title": "Opportunity key",
            "type": "string",
            "description": "Opportunities only. The HigherGov opportunity key, to read one opportunity."
          },
          "sourceId": {
            "title": "Source solicitation ID",
            "type": "string",
            "description": "Opportunities only. The solicitation number at the source, such as a SAM.gov notice ID."
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "default",
              "newest",
              "oldest",
              "latestAction",
              "largest",
              "dueSoonest"
            ],
            "type": "string",
            "description": "Newest and Oldest sort by captured date (opportunities, state and local awards), last modified date (federal awards) or SAM update (awardees). Latest action sorts by posted date, action date or start date. Largest sorts by award value. Due soonest is for opportunities. A choice the endpoint does not offer falls back to the default order.",
            "default": "default"
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "The most records this run returns and charges for, read 100 per page. Every record also counts against your HigherGov API allowance (10,000 records a month on the base plan), so keep it modest.",
            "default": 100
          },
          "requestsPerMinute": {
            "title": "Requests per minute",
            "minimum": 1,
            "maximum": 300,
            "type": "integer",
            "description": "Pacing. A rate limit answer is waited out and retried.",
            "default": 30
          },
          "apiKey": {
            "title": "API key",
            "type": "string",
            "description": "Your own HigherGov API key (an account admin creates it under the gear icon, then API). Stored as a secret, sent only to www.highergov.com as the api_key parameter, and never logged. You can instead set the DATA_API_KEY environment secret."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}