API Reference

Complete documentation for all 15 GovData Labs endpoints. Every request uses X-API-Key header authentication.

Authentication

Include your API key in every request via the header:

X-API-Key: dk_live_your_key_here

Rate Limits

Daily request limits by tier:

Starter1,000/day

Professional10,000/day

Enterprise100,000/day

Error Codes

401Invalid API key

403Tier access denied

429Rate limit exceeded

500Server error

GET/api/v2/data/entities/searchstarter

Search Entities

Search across 845K+ registered federal contractors by name, NAICS code, state, certifications, and more.

Parameters

Name	Type	Required	Description
q	string	optional	Free-text search query
state	string	optional	Two-letter state code (e.g., VA, MD)
naics	string	optional	NAICS code filter
small_business	boolean	optional	Filter to small businesses only
cage_code	string	optional	CAGE code lookup
limit	integer	optional	Results per page (max varies by tier)
offset	integer	optional	Pagination offset

Example Request

curl "https://api.govdatalabs.com/api/v2/data/entities/search?q=cybersecurity&state=VA&small_business=true&limit=2" \
  -H "X-API-Key: your_api_key"

Example Response

200 OK — application/json

{
  "count": 2,
  "limit": 2,
  "offset": 0,
  "results": [
    {
      "certifications": {
        "8a": false,
        "hubzone": false,
        "sdvosb": false,
        "small_business": false,
        "wosb": false
      },
      "city": "PURCELLVILLE",
      "company_size": null,
      "country_code": "US",
      "dba_name": "",
      "legal_business_name": "0DAYCYBER LLC",
      "primary_naics": "541990",
      "state": "VA",
      "unique_entity_id": "CDXDKNGE19Z8",
      "website": "https://0daycyber.com/",
      "zip": "20132"
    }
  ],
  "tier": "enterprise"
}