find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/hackforddata-com:hackforddata-com-watchlists-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Hackford Public Watchlists API
  version: v1
  description: Versioned public API for Hackford regulated-firm intelligence. Firm type is Hackford's public regulated-firm grouping contract.
  contact:
    email: support@hackforddata.com
servers:
- url: https://api.hackforddata.com/v1
  description: Production
tags:
- name: Watchlists
paths:
  /saved-searches/{saved_search_id}/watchlist:
    post:
      operationId: saved_searches_watchlist_create
      description: Execute a supported firm saved search and atomically create a watchlist containing every match. Unsupported criteria are never ignored.
      summary: Create a watchlist from a saved search
      parameters:
      - in: path
        name: saved_search_id
        schema:
          type: integer
        required: true
      tags:
      - Watchlists
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: {}
          application/x-www-form-urlencoded:
            schema:
              type: object
              additionalProperties: {}
          multipart/form-data:
            schema:
              type: object
              additionalProperties: {}
      security:
      - OAuthAccessTokenAuth: []
      - PublicApiKeyAuth: []
      - jwtAuth: []
      - tokenAuth: []
      - cookieAuth: []
      responses:
        '201':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: {}
          description: ''
  /watchlists:
    get:
      operationId: watchlists_list
      tags:
      - Watchlists
      security:
      - OAuthAccessTokenAuth: []
      - PublicApiKeyAuth: []
      - jwtAuth: []
      - tokenAuth: []
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PublicApiWatchlist'
          description: ''
      summary: Watchlists list
      x-summary-source: derived
    post:
      operationId: watchlists_create
      tags:
      - Watchlists
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublicApiWatchlistRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PublicApiWatchlistRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PublicApiWatchlistRequest'
        required: true
      security:
      - OAuthAccessTokenAuth: []
      - PublicApiKeyAuth: []
      - jwtAuth: []
      - tokenAuth: []
      - cookieAuth: []
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiWatchlist'
          description: ''
      summary: Watchlists create
      x-summary-source: derived
  /watchlists/{watchlist_id}:
    get:
      operationId: watchlists_retrieve
      parameters:
      - in: path
        name: watchlist_id
        schema:
          type: integer
        required: true
      tags:
      - Watchlists
      security:
      - OAuthAccessTokenAuth: []
      - PublicApiKeyAuth: []
      - jwtAuth: []
      - tokenAuth: []
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiWatchlist'
          description: ''
      summary: Watchlists retrieve
      x-summary-source: derived
    patch:
      operationId: watchlists_partial_update
      parameters:
      - in: path
        name: watchlist_id
        schema:
          type: integer
        required: true
      tags:
      - Watchlists
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedPublicApiWatchlistRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PatchedPublicApiWatchlistRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PatchedPublicApiWatchlistRequest'
      security:
      - OAuthAccessTokenAuth: []
      - PublicApiKeyAuth: []
      - jwtAuth: []
      - tokenAuth: []
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiWatchlist'
          description: ''
      summary: Watchlists partial update
      x-summary-source: derived
    delete:
      operationId: watchlists_destroy
      parameters:
      - in: path
        name: watchlist_id
        schema:
          type: integer
        required: true
      tags:
      - Watchlists
      security:
      - OAuthAccessTokenAuth: []
      - PublicApiKeyAuth: []
      - jwtAuth: []
      - tokenAuth: []
      - cookieAuth: []
      responses:
        '204':
          description: No response body
      summary: Watchlists destroy
      x-summary-source: derived
  /watchlists/{watchlist_id}/firms:
    post:
      operationId: watchlists_firms_create
      parameters:
      - in: path
        name: watchlist_id
        schema:
          type: integer
        required: true
      tags:
      - Watchlists
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: {}
          application/x-www-form-urlencoded:
            schema:
              type: object
              additionalProperties: {}
          multipart/form-data:
            schema:
              type: object
              additionalProperties: {}
      security:
      - OAuthAccessTokenAuth: []
      - PublicApiKeyAuth: []
      - jwtAuth: []
      - tokenAuth: []
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: {}
          description: ''
      summary: Watchlists firms create
      x-summary-source: derived
  /watchlists/{watchlist_id}/firms/{hackford_id}:
    delete:
      operationId: watchlists_firms_destroy
      parameters:
      - in: path
        name: hackford_id
        schema:
          type: string
        required: true
      - in: path
        name: watchlist_id
        schema:
          type: integer
        required: true
      tags:
      - Watchlists
      security:
      - OAuthAccessTokenAuth: []
      - PublicApiKeyAuth: []
      - jwtAuth: []
      - tokenAuth: []
      - cookieAuth: []
      responses:
        '204':
          description: No response body
      summary: Watchlists firms destroy
      x-summary-source: derived
  /watchlists/{watchlist_id}/items:
    get:
      operationId: watchlists_items_retrieve
      parameters:
      - in: query
        name: page
        schema:
          type: integer
      - in: query
        name: page_size
        schema:
          type: integer
      - in: path
        name: watchlist_id
        schema:
          type: integer
        required: true
      tags:
      - Watchlists
      security:
      - OAuthAccessTokenAuth: []
      - PublicApiKeyAuth: []
      - jwtAuth: []
      - tokenAuth: []
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: {}
          description: ''
      summary: Watchlists items retrieve
      x-summary-source: derived
components:
  schemas:
    PublicApiWatchlist:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        scope:
          type: string
          readOnly: true
        can_edit:
          type: boolean
          readOnly: true
        name:
          type: string
          maxLength: 255
        description:
          type:
          - string
          - 'null'
          maxLength: 2000
        email_alerts_enabled:
          type: boolean
          description: Whether to send weekly email alerts for changes in this watchlist
        alert_filters: {}
        item_count:
          type: integer
          readOnly: true
          default: 0
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
      required:
      - can_edit
      - created_at
      - id
      - item_count
      - name
      - scope
      - updated_at
    PublicApiWatchlistRequest:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 255
        description:
          type:
          - string
          - 'null'
          maxLength: 2000
        email_alerts_enabled:
          type: boolean
          description: Whether to send weekly email alerts for changes in this watchlist
        alert_filters: {}
      required:
      - name
    PatchedPublicApiWatchlistRequest:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 255
        description:
          type:
          - string
          - 'null'
          maxLength: 2000
        email_alerts_enabled:
          type: boolean
          description: Whether to send weekly email alerts for changes in this watchlist
        alert_filters: {}
  securitySchemes:
    OAuthAccessTokenAuth:
      type: http
      scheme: bearer
      bearerFormat: OAuth 2.1 access token
    PublicApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: Hackford public API key
    cookieAuth:
      type: apiKey
      in: cookie
      name: sessionid
    jwtAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Token-based authentication with required prefix "Token"