govconapi-com API

openapi: 3.1.0
info:
  title: govconapi-com API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 19 operation(s) read from 7 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; govconapi-com has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 10
    documentation: 9
    pages-with-code: 5
    pages-read: 7
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://govconapi.com/companies-api
  - https://govconapi.com/subawards-api
  - https://govconapi.com/vendor-risk-api
  - https://govconapi.com/teaming-partner-api
  - https://govconapi.com/federal-contract-awards-api
  - https://govconapi.com/federal-contractor-search-api
  - https://govconapi.com/api-guide/search-endpoint
paths:
  /api/v1/companies/{uei}:
    get:
      operationId: get_api_v1_companies_uei
      tags:
      - Api
      summary: 'Company Intelligence API: Federal Contractor Profile, Awards, NAICS, Peers'
      description: Aggregated profile for a contractor identified by UEI.
      x-source: https://govconapi.com/companies-api
      parameters:
      - name: uei
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CompaniesUeiResponse'
      x-evidence:
        kind: documentation
  /api/v1/companies/{uei}/awards:
    get:
      operationId: get_api_v1_companies_uei_awards
      tags:
      - Api
      summary: 'Company Intelligence API: Federal Contractor Profile, Awards, NAICS, Peers'
      description: Paginated award history for a contractor.
      x-source: https://govconapi.com/companies-api
      parameters:
      - name: uei
        in: path
        required: true
        schema:
          type: string
      - name: page
        in: query
        required: false
        schema:
          type: string
        description: Page number for pagination
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CompaniesUeiAwardsResponse'
      x-evidence:
        kind: documentation
  /api/v1/companies/{uei}/peers:
    get:
      operationId: get_api_v1_companies_uei_peers
      tags:
      - Api
      summary: 'Company Intelligence API: Federal Contractor Profile, Awards, NAICS, Peers'
      description: Returns similar companies ranked by NAICS and agency overlap.
      x-source: https://govconapi.com/companies-api
      parameters:
      - name: uei
        in: path
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Maximum number of similar companies to return
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CompaniesUeiPeersResponse'
      x-evidence:
        kind: documentation
  /api/v1/companies/{uei}/prime-relationships:
    get:
      operationId: get_api_v1_companies_uei_prime_relationships
      tags:
      - Api
      summary: 'Sub‑side reverse lookup: every prime that paid this UEI as a sub‑vendor.'
      x-source: https://govconapi.com/subawards-api
      parameters:
      - name: uei
        in: path
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum records returned (up to 100 free, 1000 paid).
      - name: offset
        in: query
        required: false
        schema:
          type: integer
        description: Zero‑based offset.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CompaniesUeiPrimeRelationshipsResponse'
      x-evidence:
        kind: documentation
  /api/v1/companies/{uei}/subawards:
    get:
      operationId: get_api_v1_companies_uei_subawards
      tags:
      - Api
      summary: 'Prime‑side reverse lookup: every sub this UEI paid as a prime contractor.'
      x-source: https://govconapi.com/subawards-api
      parameters:
      - name: uei
        in: path
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum records returned (up to 100 free, 1000 paid).
      - name: offset
        in: query
        required: false
        schema:
          type: integer
        description: Zero‑based offset.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CompaniesUeiSubawardsResponse'
      x-evidence:
        kind: documentation
  /api/v1/contracts/{piid}:
    get:
      operationId: get_api_v1_contracts_piid
      tags:
      - Api
      summary: Single contract detail (latest transaction plus a roll‑up across every transaction under this PIID)
      x-source: https://govconapi.com/federal-contract-awards-api
      parameters:
      - name: piid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/contracts/{piid}/modifications:
    get:
      operationId: get_api_v1_contracts_piid_modifications
      tags:
      - Api
      summary: Full transaction history for one PIID, oldest action first
      x-source: https://govconapi.com/federal-contract-awards-api
      parameters:
      - name: piid
        in: path
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Result limit (default 100, up to 1,000 paid).
      - name: offset
        in: query
        required: false
        schema:
          type: integer
        description: Pagination offset.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/entities/E7XWKERHVVD9:
    get:
      operationId: get_api_v1_entities_E7XWKERHVVD9
      tags:
      - Api
      summary: Live example. GET /api/v1/entities/E7XWKERHVVD9.
      x-source: https://govconapi.com/subawards-api
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1EntitiesE7Xwkerhvvd9Response'
      x-evidence:
        kind: documentation
  /api/v1/entities/search:
    get:
      operationId: get_api_v1_entities_search
      tags:
      - Api
      summary: 'Federal Contractor Search API: NAICS, State, Certification, Active-Only Filters'
      x-source: https://govconapi.com/federal-contractor-search-api
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: case-insensitive name substring (2-100 chars). Trigram-indexed for fuzzy matches.
      - name: naics
        in: query
        required: false
        schema:
          type: string
        description: 6-digit NAICS code (no Y/N suffix). Matches both the entity's primary NAICS and any of its claimed secondary NAICS.
      - name: naics_small
        in: query
        required: false
        schema:
          type: string
        description: SBA's authoritative determination of which firms are small for a 6-digit NAICS.
      - name: state
        in: query
        required: false
        schema:
          type: string
        description: 2-letter US state code. Matches the entity's registered physical state.
      - name: business_type
        in: query
        required: false
        schema:
          type: string
        description: 2-3 char SAM business-type code (e.g. 8W WOSB, QF SDVOSB, 27 Self-Cert SDB, A8 Non-Profit).
      - name: active_only
        in: query
        required: false
        schema:
          type: string
        description: restrict to currently-active SAM registrations.
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: page size (default 100, max 100 free, 1000 paid).
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: offset for pagination (≥0, default 0).
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1EntitiesSearchResponse'
      x-evidence:
        kind: documentation
  /api/v1/exclusions/N2EDPB1SMN55:
    get:
      operationId: get_api_v1_exclusions_N2EDPB1SMN55
      tags:
      - Api
      summary: GET /api/v1/exclusions/N2EDPB1SMN55
      x-source: https://govconapi.com/subawards-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -H \"Authorization: Bearer $KEY\"  \"https://govconapi.com/api/v1/exclusions/N2EDPB1SMN55\"\n vs. USAspending, Tango, HigherGov,\
          \ GovTribe \n USAspending publishes the same source data this API serves. Their bulk_download interface works if you want one fiscal\
          \ year as a CSV load and have a warehouse to ingest 118 columns. Their per-record award API does not paginate sub-vendor lookups by\
          \ UEI, and th"
  /api/v1/exclusions/SMFQMVEAJVM9:
    get:
      operationId: get_api_v1_exclusions_SMFQMVEAJVM9
      tags:
      - Api
      summary: Live example. GET /api/v1/exclusions/SMFQMVEAJVM9 (HM 2 Mechanical & Specialty Contractors).
      x-source: https://govconapi.com/subawards-api
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1ExclusionsSmfqmveajvm9Response'
      x-evidence:
        kind: documentation
  /api/v1/offices/{officeCode}:
    get:
      operationId: get_api_v1_offices_officeCode
      tags:
      - Api
      summary: Awarding Office and Contracting Officer Contacts
      x-source: https://govconapi.com/federal-contract-awards-api
      parameters:
      - name: officeCode
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/opportunities/delta:
    get:
      operationId: get_api_v1_opportunities_delta
      tags:
      - Api
      summary: Delta sync endpoint to get only records changed since a timestamp.
      description: Used to keep a local copy in sync by retrieving only changed opportunities.
      x-source: https://govconapi.com/api-guide/search-endpoint
      parameters:
      - name: timestamp
        in: query
        required: true
        schema:
          type: string
        description: Pass a timestamp to receive only changes since that time.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1OpportunitiesDeltaResponse'
      x-evidence:
        kind: documentation
  /api/v1/opportunities/search:
    get:
      operationId: get_api_v1_opportunities_search
      tags:
      - Api
      summary: 'Company Intelligence API: Federal Contractor Profile, Awards, NAICS, Peers'
      description: Search opportunities with optional NAICS, agency, notice type, and date filters.
      x-source: https://govconapi.com/companies-api
      parameters:
      - name: naics
        in: query
        required: false
        schema:
          type: string
        description: NAICS code to filter opportunities
      - name: agency
        in: query
        required: false
        schema:
          type: string
        description: Agency name to filter opportunities
      - name: notice_type
        in: query
        required: false
        schema:
          type: string
        description: Notice type (e.g., Award Notice)
      - name: date_from
        in: query
        required: false
        schema:
          type: string
        description: Start date for the search window
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1OpportunitiesSearchResponse'
      x-evidence:
        kind: documentation
  /api/v1/partners/search:
    get:
      operationId: get_api_v1_partners_search
      tags:
      - Api
      summary: GET /api/v1/partners/search
      x-source: https://govconapi.com/teaming-partner-api
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
      - name: naics
        in: query
        required: false
        schema:
          type: string
      - name: set_aside
        in: query
        required: false
        schema:
          type: string
      - name: state
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -H \"Authorization: Bearer YOUR_KEY\"  \"https://govconapi.com/api/v1/partners/search?set_aside=sdvosb&state=VA&naics=541512&limit=1\"\
          \n 135 firms; top is Liberty IT Solutions, $228M \n {\n \"data\": [\n {\n \"uei\": \"GLGMWJ8EVMR9\",\n \"name\": \"LIBERTY IT SOLUTIONS\
          \ LLC\",\n \"contracts\": 5,\n \"gross_obligated\": 228028115.0,\n \"last_award_date\": \"2025-03-20\",\n \"set_asides\": [\"sdvosb\"\
          , \"vosb\", \"sdb\"],\n \"agencies\":"
  /api/v1/subawards/{subawardSamReportId}:
    get:
      operationId: get_api_v1_subawards_subawardSamReportId
      tags:
      - Api
      summary: Single FFATA report by SAM report ID (UUID, the natural primary key).
      description: Full 118‑column FFATA record.
      x-source: https://govconapi.com/subawards-api
      parameters:
      - name: subawardSamReportId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1SubawardsSubawardsamreportidResponse'
      x-evidence:
        kind: documentation
  /api/v1/vendor-risk/bulk:
    post:
      operationId: post_api_v1_vendor_risk_bulk
      tags:
      - Api
      summary: POST /api/v1/vendor-risk/bulk
      x-source: https://govconapi.com/vendor-risk-api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1VendorRiskBulkRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST -H \"Authorization: Bearer $KEY\"  -H \"Content-Type: application/json\"  -d '{\"ueis\": [\"N2EDPB1SMN55\", \"\
          C1BVCA2N9YB4\", \"SH2ER4W6LH13\"]}'  \"https://govconapi.com/api/v1/vendor-risk/bulk\"\n Both return the full signal set plus a mechanical\
          \ triage verdict ( high / elevated / needs_review / clean / unknown ) with the rules that fired. Part of our $39/mo Pro, same API key\
          \ as the other endpoint"
  /api/v1/vendor-risk/{vendorriskid}:
    get:
      operationId: get_api_v1_vendor_risk_vendorriskid
      tags:
      - Api
      summary: GET /api/v1/vendor-risk/N2EDPB1SMN55
      x-source: https://govconapi.com/vendor-risk-api
      parameters:
      - name: vendorriskid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -H \"Authorization: Bearer $KEY\"  \"https://govconapi.com/api/v1/vendor-risk/N2EDPB1SMN55\"\n Bulk (up to 100 UEIs per\
          \ request): "
        collapsed_from: 2 example path(s) differing only at vendorriskId
  /ezsearch/FEEDS/ATOM:
    get:
      operationId: get_ezsearch_FEEDS_ATOM
      tags:
      - Ezsearch
      summary: FPDS‑NG Atom feed (official XML feed)
      x-source: https://govconapi.com/federal-contract-awards-api
      parameters:
      - name: FEEDNAME
        in: query
        required: false
        schema:
          type: string
        description: Feed name, e.g., PUBLIC.
      - name: templateName
        in: query
        required: false
        schema:
          type: string
        description: Template version, e.g., 1.5.3.
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Search‑string query language, e.g., NAICS_CODE:541512 LAST_MOD_DATE:[2026/06/25,2026/06/26].
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiV1CompaniesUeiResponse:
      type: object
      properties:
        uei:
          type: string
        name:
          type: string
        primary_city:
          type: string
        primary_state:
          type: string
        total_awards:
          type: integer
        total_value:
          type: number
        avg_value:
          type: number
        first_award_date:
          type: string
        last_award_date:
          type: string
        awards_last_90d:
          type: integer
        awards_last_12mo:
          type: integer
        top_naics:
          type: array
        top_agencies:
          type: array
        top_agency_share_pct:
          type: number
        set_aside_distribution:
          type: array
        registration:
          type: object
        entity:
          type: object
        sub_revenue_total:
          type: number
        top_paying_primes:
          type: array
        fpds_obligated_total:
          type: number
        fpds_distinct_contracts:
          type: integer
        fpds_transaction_count:
          type: integer
        fpds_first_action_date:
          type: string
        fpds_latest_action_date:
          type: string
        fpds_top_naics:
          type: array
        fpds_top_agencies:
          type: array
        prime_revenue_share:
          type: number
    GetApiV1CompaniesUeiAwardsResponse:
      type: object
      properties:
        awards:
          type: array
        page:
          type: integer
        total_pages:
          type: integer
    GetApiV1CompaniesUeiPeersResponse:
      type: object
      properties:
        peers:
          type: array
    GetApiV1CompaniesUeiPrimeRelationshipsResponse:
      type: object
      properties:
        summary:
          type: object
          description: Aggregated totals, distinct counters, date range, top paying primes.
        data:
          type: array
          description: Array of subaward rows (default 29 fields).
    GetApiV1CompaniesUeiSubawardsResponse:
      type: object
      properties:
        summary:
          type: object
          description: Aggregated totals, distinct counters, date range, top paying primes.
        data:
          type: array
          description: Array of subaward rows (default 29 fields).
    GetApiV1EntitiesE7Xwkerhvvd9Response:
      type: object
      properties:
        sub_revenue_total:
          type: number
          description: Total FFATA subaward revenue for this entity.
        top_paying_primes:
          type: array
          description: Top paying primes for this entity.
    GetApiV1EntitiesSearchResponse:
      type: object
      properties:
        query:
          type: object
          description: Echo of the query parameters used.
        pagination:
          type: object
          description: Pagination metadata (limit, offset, total, has_next).
        results:
          type: array
          description: Array of entity short records.
        results[].uei:
          type: string
          description: Unique Entity Identifier.
        results[].legal_business_name:
          type: string
          description: Legal business name.
        results[].dba_name:
          type: string
          description: Doing‑business‑as name.
        results[].registration_status:
          type: string
          description: Registration status code.
        results[].registration_expiration_date:
          type: string
          description: Expiration date of registration.
        results[].primary_naics:
          type: string
          description: Primary NAICS code.
        results[].business_types:
          type: array
          description: List of SAM business‑type codes.
        results[].business_types_labels:
          type: array
          description: Human‑readable labels for business types.
        results[].physical_city:
          type: string
          description: Physical city of the entity.
        results[].physical_state:
          type: string
          description: Physical state of the entity.
        results[].physical_country:
          type: string
          description: Physical country of the entity.
    GetApiV1ExclusionsSmfqmveajvm9Response:
      type: object
      properties:
        recent_sub_payments:
          type: object
          description: Summary of FFATA subaward dollars this excluded UEI has received in the last 12 months.
    GetApiV1OpportunitiesDeltaResponse:
      type: object
      properties:
        data:
          type: array
          description: Changed opportunity records.
        pagination:
          type: object
          description: Pagination info.
    GetApiV1OpportunitiesSearchResponse:
      type: object
      properties:
        results:
          type: array
    GetApiV1SubawardsSubawardsamreportidResponse:
      type: object
      properties:
        subaward_sam_report_id:
          type: string
        subaward_number:
          type: string
        subaward_action_date:
          type: string
          description: Date of the subaward action.
        subaward_amount:
          type: number
        prime_award_piid:
          type: string
        subawardee_uei:
          type: string
        subawardee_name:
          type: string
    PostApiV1VendorRiskBulkRequest:
      type: object
      properties:
        ueis:
          type: array
          items:
            type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Ezsearch