{"openapi":"3.1.0","info":{"title":"GlobalGov Developer API","description":"Read-only REST access to GlobalGov's government-procurement corpus — solicitations, contract awards, vendors (entities), and agencies from national and multilateral sources, whatever language they were published in. Authenticate with a `ggk_` API key (`Authorization: Bearer ggk_live_...`). Cursor-paginated, explicit response schemas, RFC 9457 problem+json errors. No personal contact data is exposed. API access is included on paid plans (free through 22 October 2026, see https://globalgov.io/pricing); custom plans for high-volume use. Full guide: https://globalgov.io/developers","version":"1.0.0"},"servers":[{"url":"/api/public"},{"url":"https://globalgov.io/api/public","description":"Live base URL"}],"paths":{"/v1/solicitations":{"get":{"tags":["Solicitations"],"summary":"List solicitations","operationId":"list_solicitations_v1_solicitations_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"ISO 3166-1 alpha-2 country code","title":"Country"},"description":"ISO 3166-1 alpha-2 country code"},{"name":"naics","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Naics"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"e.g. ACTIVE, RFP","title":"Status"},"description":"e.g. ACTIVE, RFP"},{"name":"posted_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"published_date >= this date","title":"Posted After"},"description":"published_date >= this date"},{"name":"active","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true returns only solicitations not in a terminal lifecycle state (AWARDED, CANCELLED, CLOSED, EXPIRED). This is a lifecycle filter, not an open-for-bidding filter: it does not check the response deadline.","title":"Active"},"description":"true returns only solicitations not in a terminal lifecycle state (AWARDED, CANCELLED, CLOSED, EXPIRED). This is a lifecycle filter, not an open-for-bidding filter: it does not check the response deadline."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Solicitation_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/solicitations/{solicitation_id}":{"get":{"tags":["Solicitations"],"summary":"Get a solicitation","operationId":"get_solicitation_v1_solicitations__solicitation_id__get","parameters":[{"name":"solicitation_id","in":"path","required":true,"schema":{"type":"string","title":"Solicitation Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Solicitation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/awards":{"get":{"tags":["Awards"],"summary":"List contract awards","operationId":"list_awards_v1_awards_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Buyer country (ISO alpha-2)","title":"Country"},"description":"Buyer country (ISO alpha-2)"},{"name":"naics","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Naics"}},{"name":"awarded_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"award_date >= this date","title":"Awarded After"},"description":"award_date >= this date"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Award_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/awards/{award_id}":{"get":{"tags":["Awards"],"summary":"Get an award","operationId":"get_award_v1_awards__award_id__get","parameters":[{"name":"award_id","in":"path","required":true,"schema":{"type":"string","title":"Award Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Award"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vendors":{"get":{"tags":["Vendors"],"summary":"List vendors","operationId":"list_vendors_v1_vendors_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"small_business","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Small Business"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Vendor_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vendors/{vendor_id}":{"get":{"tags":["Vendors"],"summary":"Get a vendor","operationId":"get_vendor_v1_vendors__vendor_id__get","parameters":[{"name":"vendor_id","in":"path","required":true,"schema":{"type":"string","title":"Vendor Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Vendor"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agencies":{"get":{"tags":["Agencies"],"summary":"List agencies","operationId":"list_agencies_v1_agencies_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Agency_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agencies/{agency_id}":{"get":{"tags":["Agencies"],"summary":"Get an agency","operationId":"get_agency_v1_agencies__agency_id__get","parameters":[{"name":"agency_id","in":"path","required":true,"schema":{"type":"string","title":"Agency Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agency"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ping":{"get":{"tags":["Meta"],"summary":"Authenticated smoke test","operationId":"ping_v1_ping_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Agency":{"properties":{"id":{"type":"string","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"abbreviation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Abbreviation"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"country_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Name"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"agency_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agency Type"},"agency_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agency Level"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"mission_statement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mission Statement"},"total_annual_spend_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Annual Spend Usd"},"active_solicitations_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Solicitations Count"},"total_awards_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Awards Count"},"total_awards_value_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Awards Value Usd"},"avg_contract_value_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Contract Value Usd"},"top_categories":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Top Categories"},"top_naics_codes":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Top Naics Codes"}},"type":"object","required":["id"],"title":"Agency"},"Award":{"properties":{"id":{"type":"string","title":"Id"},"award_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Award Number"},"award_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Award Date"},"award_value_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Award Value Usd"},"total_obligated_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Obligated Usd"},"ceiling_value_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ceiling Value Usd"},"award_value_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Award Value Currency"},"vendor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Name"},"vendor_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Country"},"buyer_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buyer Country"},"awarding_office_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Awarding Office Name"},"naics_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naics Code"},"psc_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Psc Code"},"contract_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contract Type"},"set_aside_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Set Aside Type"},"place_of_performance_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Of Performance Country"},"period_of_performance_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Period Of Performance Start"},"period_of_performance_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Period Of Performance End"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"solicitation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Solicitation Id"},"vendor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Id"},"awarding_agency_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Awarding Agency Id"}},"type":"object","required":["id"],"title":"Award"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Page_Agency_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Agency"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["data"],"title":"Page[Agency]"},"Page_Award_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Award"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["data"],"title":"Page[Award]"},"Page_Solicitation_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Solicitation"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["data"],"title":"Page[Solicitation]"},"Page_Vendor_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Vendor"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["data"],"title":"Page[Vendor]"},"Solicitation":{"properties":{"id":{"type":"string","title":"Id"},"solicitation_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Solicitation Number"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"title_original":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Original"},"agency_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agency Name"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"country_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Name"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"solicitation_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Solicitation Type"},"naics_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naics Code"},"naics_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naics Description"},"psc_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Psc Code"},"cpv_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cpv Code"},"unspsc_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unspsc Code"},"subcategory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subcategory"},"value_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value Usd"},"value_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value Amount"},"value_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value Currency"},"value_usd_exchange_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value Usd Exchange Rate"},"value_usd_exchange_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Value Usd Exchange Date"},"published_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published Date"},"response_due_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Response Due Date"},"question_due_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Question Due Date"},"opportunity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Opportunity Type"},"procurement_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procurement Method"},"procurement_method_details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procurement Method Details"},"set_aside_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Set Aside Type"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province"},"place_of_performance_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Of Performance Country"},"place_of_performance_state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Of Performance State Province"},"place_of_performance_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Of Performance City"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"submission_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Submission Url"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"documents":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Documents"},"ocid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ocid"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id"},"source_system":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source System"},"original_language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Language"}},"type":"object","required":["id"],"title":"Solicitation"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"Vendor":{"properties":{"id":{"type":"string","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"dba_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dba Name"},"uei":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uei"},"cage_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cage Code"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"business_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Type"},"employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Employee Count"},"founded_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Founded Year"},"is_small_business":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Small Business"},"is_woman_owned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Woman Owned"},"is_veteran_owned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Veteran Owned"},"is_hubzone":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Hubzone"},"naics_codes":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Naics Codes"},"total_awards_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Awards Count"},"total_awards_value_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Awards Value Usd"},"primary_countries":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Primary Countries"},"primary_naics_codes":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Primary Naics Codes"},"capability_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capability Summary"}},"type":"object","required":["id"],"title":"Vendor"}},"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"ggk_live_...","description":"API key from Settings -> API & MCP Access"}}},"security":[{"ApiKey":[]}]}