Huntertech API

openapi: 3.1.0
info:
  title: Huntertech API
  version: '2026-11-11'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-11: 21 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; Huntertech has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 18
    pages-with-code: 5
    pages-read: 7
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-11'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.huntertech.io/api
  - https://www.huntertech.io/developer
  - https://www.huntertech.io/news/public-api-and-openapi-docs
  - https://www.huntertech.io/auth
  - https://www.huntertech.io/docs/api/openapi.json
  - https://www.huntertech.io/news
  - https://www.huntertech.io/news.xml
paths:
  /advisories-unified:
    get:
      operationId: get_advisories_unified
      tags:
      - Advisories Unified
      summary: List security advisories (all vendors)
      description: Cross‑vendor security advisories.
      x-source: https://www.huntertech.io/docs/api/openapi.json
      parameters:
      - name: vendor
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated vendor slugs
      - name: timePeriod
        in: query
        required: false
        schema:
          type: string
        description: History window
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum records
      - name: skipCache
        in: query
        required: false
        schema:
          type: boolean
        description: Bypass cache
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAdvisoriesUnifiedResponse'
      x-evidence:
        kind: documentation
  /api/v1/infrastructure:
    get:
      operationId: get_api_v1_infrastructure
      tags:
      - Api
      summary: One REST API for incidents, maintenance, advisories, updates, and analytics across hundreds of vendors.
      x-source: https://www.huntertech.io/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/infrastructure/cisa-known-exploited-vulnerabilities:
    get:
      operationId: get_api_v1_infrastructure_cisa_known_exploited_vulnerabilities
      tags:
      - Api
      summary: CISA known exploited vulnerabilities
      description: CISA KEV catalog snapshot used by Huntertech security tools.
      x-source: https://www.huntertech.io/docs/api/openapi.json
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Maximum number of records to return.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1InfrastructureCisaKnownExploitedVulnerabilitiesRespo'
      x-evidence:
        kind: documentation
  /api/v1/infrastructure/incidents:
    get:
      operationId: get_api_v1_infrastructure_incidents
      tags:
      - Api
      summary: GET /api/v1/infrastructure/incidents
      x-source: https://www.huntertech.io/news/public-api-and-openapi-docs
      parameters:
      - name: activeOnly
        in: query
        required: false
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl, JavaScript, Python, Go, Ruby, PHP, PowerShell, and more. Each sample targets the canonical Infrastructure API paths, including
          vendor-list, vendors/zscaler/{dataType}, incidents, maintenance, and incidents/stream for Server-Sent Events when you need push-style
          updates instead of polling. Interactive documentation lives at docs.huntertech.io , backed by an OpenAPI spec generated from register
  /api/v1/infrastructure/vendor-list:
    get:
      operationId: get_api_v1_infrastructure_vendor_list
      tags:
      - Api
      summary: GET /api/v1/infrastructure/vendor-list
      x-source: https://www.huntertech.io/developer
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1InfrastructureVendorListResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://www.huntertech.io/api/v1/infrastructure/vendor-list  -H \"Authorization: Bearer $HUNTERTECH_API_KEY\" Response\
          \ 200 OK {\n \"vendors\": [\n { \"id\": \"aws\", \"name\": \"Amazon Web Services\", \"status\": \"operational\" },\n { \"id\": \"cloudflare\"\
          , \"name\": \"Cloudflare\", \"status\": \"degraded\" }\n ]\n} No key yet? The MCP server answers active-incident questions with zero\
          \ auth. Integrations Three ways to get "
  /api/v1/infrastructure/vendors/zscaler/compliance:
    get:
      operationId: get_api_v1_infrastructure_vendors_zscaler_compliance
      tags:
      - Api
      summary: Get vendor compliance data
      x-source: https://www.huntertech.io/docs/api/openapi.json
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1InfrastructureVendorsZscalerComplianceResponse'
      x-evidence:
        kind: documentation
  /api/v1/oauth/register:
    post:
      operationId: post_api_v1_oauth_register
      tags:
      - Api
      summary: POST /api/v1/oauth/register
      x-source: https://www.huntertech.io/auth
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: httpie
        snippet: 'http

          POST https://www.huntertech.io/api/v1/oauth/register'
  /dashboard-favorites:
    post:
      operationId: post_dashboard_favorites
      tags:
      - Dashboard Favorites
      summary: Dashboard
      x-source: https://www.huntertech.io/docs/api/openapi.json
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostDashboardFavoritesRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostDashboardFavoritesResponse'
      x-evidence:
        kind: documentation
  /incidents:
    get:
      operationId: get_incidents
      tags:
      - Incidents
      summary: Cross-vendor outage feed with active-only filters, vendor scoping, and SSE streaming.
      x-source: https://www.huntertech.io/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /incidents/stream:
    get:
      operationId: get_incidents_stream
      tags:
      - Incidents
      summary: Quick start Start building in minutes.
      x-source: https://www.huntertech.io/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /maintenance:
    get:
      operationId: get_maintenance
      tags:
      - Maintenance
      summary: Scheduled and in-progress maintenance windows from every tracked vendor.
      x-source: https://www.huntertech.io/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /nvd-cves:
    get:
      operationId: get_nvd_cves
      tags:
      - Nvd Cves
      summary: NVD CVE feed
      description: Cached NVD CVE listings.
      x-source: https://www.huntertech.io/docs/api/openapi.json
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum number of records to return
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetNvdCvesResponse'
      x-evidence:
        kind: documentation
  /press-releases:
    get:
      operationId: get_press_releases
      tags:
      - Press Releases
      summary: List press releases (all vendors)
      description: Cross‑vendor official press and news.
      x-source: https://www.huntertech.io/docs/api/openapi.json
      parameters:
      - name: vendor
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated vendor slugs
      - name: timePeriod
        in: query
        required: false
        schema:
          type: string
        description: History window
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum records
      - name: skipCache
        in: query
        required: false
        schema:
          type: boolean
        description: Bypass cache
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPressReleasesResponse'
      x-evidence:
        kind: documentation
  /reports/generate:
    post:
      operationId: post_reports_generate
      tags:
      - Reports
      summary: Quarterly QBR reports (Enterprise / VIP)
      x-source: https://www.huntertech.io/docs/api/openapi.json
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostReportsGenerateResponse'
      x-evidence:
        kind: documentation
  /reports/{id}/download:
    get:
      operationId: get_reports_id_download
      tags:
      - Reports
      summary: Quarterly QBR reports (Enterprise / VIP)
      x-source: https://www.huntertech.io/docs/api/openapi.json
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetReportsIdDownloadResponse'
      x-evidence:
        kind: documentation
  /vendor-capabilities/{vendor}:
    get:
      operationId: get_vendor_capabilities_vendor
      tags:
      - Vendor Capabilities
      summary: Vendor capabilities
      x-source: https://www.huntertech.io/docs/api/openapi.json
      parameters:
      - name: vendor
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetVendorCapabilitiesVendorResponse'
      x-evidence:
        kind: documentation
  /vendor-list:
    get:
      operationId: get_vendor_list
      tags:
      - Vendor List
      summary: Start with GET /vendor-list to discover slugs.
      x-source: https://www.huntertech.io/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /vendor-stats/{vendor}:
    get:
      operationId: get_vendor_stats_vendor
      tags:
      - Vendor Stats
      summary: Real-time Push-style incident updates over Server-Sent Events instead of aggressive polling.
      x-source: https://www.huntertech.io/api
      parameters:
      - name: vendor
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /vendor-status/{vendor}:
    get:
      operationId: get_vendor_status_vendor
      tags:
      - Vendor Status
      summary: Vendor status
      description: Current operational status summary for a vendor.
      x-source: https://www.huntertech.io/docs/api/openapi.json
      parameters:
      - name: vendor
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetVendorStatusVendorResponse'
      x-evidence:
        kind: documentation
  /vendors/{vendor}/incident-stub/{incidentref}:
    get:
      operationId: get_vendors_vendor_incident_stub_incidentref
      tags:
      - Vendors
      summary: Vendor incident stub
      x-source: https://www.huntertech.io/docs/api/openapi.json
      parameters:
      - name: vendor
        in: path
        required: true
        schema:
          type: string
      - name: incidentref
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetVendorsVendorIncidentStubIncidentrefResponse'
      x-evidence:
        kind: documentation
  /vendors/{vendor}/{datatype}:
    get:
      operationId: get_vendors_vendor_datatype
      tags:
      - Vendors
      summary: One vendor, one data type
      description: Fetch a specific data type for a single vendor.
      x-source: https://www.huntertech.io/docs/api/openapi.json
      parameters:
      - name: vendor
        in: path
        required: true
        schema:
          type: string
      - name: datatype
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetVendorsVendorDatatypeResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetAdvisoriesUnifiedResponse:
      type: object
      properties:
        success:
          type: boolean
        items:
          type: array
          description: Advisory records
        total:
          type: integer
        fetchedAt:
          type: string
          description: date‑time
        source:
          type: string
    GetApiV1InfrastructureCisaKnownExploitedVulnerabilitiesRespo:
      type: object
      properties:
        success:
          type: boolean
          description: Indicates request success.
        items:
          type: array
          description: Incident, maintenance, advisory, or update records.
        total:
          type: integer
          description: Total number of records (if provided).
        fetchedAt:
          type: string
          description: Timestamp of fetch.
        source:
          type: string
          description: Data source identifier.
    GetApiV1InfrastructureVendorListResponse:
      type: object
      properties:
        vendors:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              name:
                type: string
              status:
                type: string
    GetApiV1InfrastructureVendorsZscalerComplianceResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Indicates request success
        vendor:
          type: string
          description: Vendor slug
        items:
          type: array
          description: Compliance certification records
    PostDashboardFavoritesRequest:
      type: object
      properties:
        vendors:
          type: array
          description: List of vendor slugs
        sections:
          type: array
          description: Requested sections (e.g., stats, maintenance)
      required:
      - vendors
    PostDashboardFavoritesResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Indicates request success
        data:
          type: object
          description: Aggregated dashboard data
    GetNvdCvesResponse:
      type: object
      properties:
        success:
          type: boolean
        items:
          type: array
          description: CVE records
        total:
          type: integer
        fetchedAt:
          type: string
          description: date‑time
        source:
          type: string
    GetPressReleasesResponse:
      type: object
      properties:
        success:
          type: boolean
        items:
          type: array
          description: Press release records
        total:
          type: integer
        fetchedAt:
          type: string
          description: date‑time
        source:
          type: string
    PostReportsGenerateResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Indicates request success
        reportId:
          type: string
          description: Identifier of the generated report
    GetReportsIdDownloadResponse:
      type: object
      properties:
        file:
          type: string
          description: PDF or CSV report file
    GetVendorCapabilitiesVendorResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Indicates request success
        items:
          type: array
          description: Capability descriptors
    GetVendorStatusVendorResponse:
      type: object
      properties:
        success:
          type: boolean
        items:
          type: array
          description: Current status records
        total:
          type: integer
        fetchedAt:
          type: string
          description: date‑time
        source:
          type: string
    GetVendorsVendorIncidentStubIncidentrefResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Indicates request success
        items:
          type: array
          description: Lightweight incident data
    GetVendorsVendorDatatypeResponse:
      type: object
      properties:
        success:
          type: boolean
        items:
          type: array
          description: Records of the requested data type
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Advisories Unified
- name: Api
- name: Dashboard Favorites
- name: Incidents
- name: Maintenance
- name: Nvd Cves
- name: Press Releases
- name: Reports
- name: Vendor Capabilities
- name: Vendor List
- name: Vendor Stats
- name: Vendor Status
- name: Vendors