Hint Health

Hint Health Company API

The Company API from Hint Health — 3 operation(s) for company.

GitHub OpenAPI

Operations 5

POST /provider/companies Create Company #
GET /provider/companies List All Companies #
POST /provider/companies/{id}/deactivate Deactivate Company #
GET /provider/companies/{id} Show Company #
PATCH /provider/companies/{id} Update Company #

Documentation

📖
Documentation
https://developers.hint.com/docs/overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/hint-health/refs/heads/main/openapi/hint-health-company-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/hint-health/refs/heads/main/overlays/hint-health-company-api-overlay.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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/hint-health-company-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

hint-health-company-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Hint Health Company API
  license:
    name: Private
  termsOfService: https://www.hint.com/terms
  x-refined-note:
  - x-api-evangelist-harvest differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged Company across 2 of this provider''s published API definitions: hint-health-hint-health-api-openapi.yml, hint-health-partner-endpoints-2026-07-01-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.hint.com/api
  description: Production
- url: https://api.sandbox.hint.com/api
  description: Sandbox
tags:
- name: Company
paths:
  /provider/companies:
    post:
      tags:
      - Company
      operationId: Company.CreateCompany
      summary: Create Company
      description: ''
      parameters: []
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Public.CompanyBlueprint_one'
              example:
                id: com-ab12C345DeF6
                employee_divisions_count: 0
                name: Schmoogle Inc.
                status: active
                address:
                  id: add-ab12C345DeF6
                  city: New York
                  country: United States
                  line1: 157 E Houston St
                  line2: Suite 2402
                  state: NY
                  zip: '10002'
                  latitude: 40.7227998
                  longitude: -73.9892241
                default_location: null
                default_plan:
                  id: pln-ab12C345DeF6
                  name: Membership
                  plan_type: company
                default_practitioner: null
                phones:
                - number: '5553050005'
                  type: mobile
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyCreateSanitizer'
      security:
      - BearerAuth: []
    get:
      tags:
      - Company
      operationId: Company.ListAllCompanies
      summary: List All Companies
      description: ''
      parameters: []
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Public.CompanyBlueprint_all'
              example:
              - id: com-ab12C345DeF6
                employee_divisions_count: 0
                name: Schmoogle Inc.
                status: active
                address:
                  id: add-ab12C345DeF6
                  city: New York
                  country: United States
                  line1: 157 E Houston St
                  line2: Suite 2402
                  state: NY
                  zip: '10002'
                  latitude: 40.7227998
                  longitude: -73.9892241
                default_location: null
                default_plan:
                  id: pln-ab12C345DeF6
                  name: Membership
                  plan_type: company
                default_practitioner: null
                phones:
                - number: '5553050004'
                  type: mobile
      security:
      - BearerAuth: []
    servers:
    - url: https://api.hint.com/api
      description: Production
    - url: https://api.sandbox.hint.com/api
      description: Sandbox
  /provider/companies/{id}/deactivate:
    post:
      tags:
      - Company
      operationId: Company.DeactivateCompany
      summary: Deactivate Company
      description: ''
      parameters:
      - name: id
        in: path
        required: true
        description: Unique Company ID
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Public.CompanyBlueprint_one'
              example:
                id: com-ab12C345DeF6
                employee_divisions_count: 0
                name: Schmoogle Inc.
                status: active
                address:
                  id: add-ab12C345DeF6
                  city: New York
                  country: United States
                  line1: 157 E Houston St
                  line2: Suite 2402
                  state: NY
                  zip: '10002'
                  latitude: 40.7227998
                  longitude: -73.9892241
                default_location: null
                default_plan:
                  id: pln-ab12C345DeF6
                  name: Membership
                  plan_type: company
                default_practitioner: null
                phones:
                - number: '5553050005'
                  type: mobile
      security:
      - BearerAuth: []
    servers:
    - url: https://api.hint.com/api
      description: Production
    - url: https://api.sandbox.hint.com/api
      description: Sandbox
  /provider/companies/{id}:
    get:
      tags:
      - Company
      operationId: Company.ShowCompany
      summary: Show Company
      description: ''
      parameters:
      - name: id
        in: path
        required: true
        description: Unique Company ID
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Public.CompanyBlueprint_one'
              example:
                id: com-ab12C345DeF6
                employee_divisions_count: 0
                name: Schmoogle Inc.
                status: active
                address:
                  id: add-ab12C345DeF6
                  city: New York
                  country: United States
                  line1: 157 E Houston St
                  line2: Suite 2402
                  state: NY
                  zip: '10002'
                  latitude: 40.7227998
                  longitude: -73.9892241
                default_location: null
                default_plan:
                  id: pln-ab12C345DeF6
                  name: Membership
                  plan_type: company
                default_practitioner: null
                phones:
                - number: '5553050005'
                  type: mobile
      security:
      - BearerAuth: []
    patch:
      tags:
      - Company
      operationId: Company.UpdateCompany
      summary: Update Company
      description: ''
      parameters:
      - name: id
        in: path
        required: true
        description: Unique Company ID
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Public.CompanyBlueprint_one'
              example:
                id: com-ab12C345DeF6
                employee_divisions_count: 0
                name: Schmoogle Inc.
                status: active
                address:
                  id: add-ab12C345DeF6
                  city: New York
                  country: United States
                  line1: 157 E Houston St
                  line2: Suite 2402
                  state: NY
                  zip: '10002'
                  latitude: 40.7227998
                  longitude: -73.9892241
                default_location: null
                default_plan:
                  id: pln-ab12C345DeF6
                  name: Membership
                  plan_type: company
                default_practitioner: null
                phones:
                - number: '5553050005'
                  type: mobile
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyUpdateSanitizer'
      security:
      - BearerAuth: []
    servers:
    - url: https://api.hint.com/api
      description: Production
    - url: https://api.sandbox.hint.com/api
      description: Sandbox
components:
  schemas:
    Public.LocationBlueprint_min:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
    CompanyCreateSanitizer:
      type: object
      properties:
        default_plan:
          $ref: '#/components/schemas/Association'
          description: You must use plans of type "company"
        name:
          type: string
        address:
          $ref: '#/components/schemas/Address'
        phones:
          type: array
          items:
            $ref: '#/components/schemas/PhoneNumber'
    Association:
      type: object
      properties:
        id:
          type: string
      required:
      - id
    PhoneNumber:
      type: object
      properties:
        id:
          type: string
        number:
          type: number
        type:
          type: string
        us_formattable:
          type: boolean
          description: Make this false if your number is not exactly 10 digits
      required:
      - number
      - type
    Public.EmployeeDivisionBlueprint_leaf:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
    Public.PlanBlueprint_min:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        plan_type:
          type: string
    Address:
      type: object
      properties:
        line1:
          type: string
        line2:
          type: string
        city:
          type: string
        state:
          type: string
        zip:
          type: string
        country:
          type: string
      required:
      - line1
      - city
      - state
      - zip
    Public.CompanyBlueprint_one:
      type: object
      properties:
        id:
          type: string
        employee_divisions_count:
          type: integer
          format: int32
        name:
          type: string
        status:
          type: string
        address:
          $ref: '#/components/schemas/Public.AddressBlueprint_leaf'
        default_location:
          $ref: '#/components/schemas/Public.LocationBlueprint_min'
        default_plan:
          $ref: '#/components/schemas/Public.PlanBlueprint_min'
        default_practitioner:
          $ref: '#/components/schemas/Public.PractitionerBlueprint_min'
        employee_divisions:
          $ref: '#/components/schemas/Public.EmployeeDivisionBlueprint_leaf'
        phones:
          $ref: '#/components/schemas/Public.PhoneBlueprint_leaf'
    CompanyUpdateSanitizer:
      type: object
      properties:
        name:
          type: string
        address:
          $ref: '#/components/schemas/Address'
        phones:
          type: array
          items:
            $ref: '#/components/schemas/PhoneNumber'
    Public.CompanyBlueprint_all:
      type: array
      items:
        type: object
        properties:
          id:
            type: string
          employee_divisions_count:
            type: integer
            format: int32
          name:
            type: string
          status:
            type: string
          address:
            $ref: '#/components/schemas/Public.AddressBlueprint_leaf'
          default_location:
            $ref: '#/components/schemas/Public.LocationBlueprint_min'
          default_plan:
            $ref: '#/components/schemas/Public.PlanBlueprint_min'
          default_practitioner:
            $ref: '#/components/schemas/Public.PractitionerBlueprint_min'
          employee_divisions:
            $ref: '#/components/schemas/Public.EmployeeDivisionBlueprint_leaf'
          phones:
            $ref: '#/components/schemas/Public.PhoneBlueprint_leaf'
    Public.AddressBlueprint_leaf:
      type: object
      properties:
        id:
          type: string
        city:
          type: string
        country:
          type: string
        line1:
          type: string
        line2:
          type: string
        state:
          type: string
        zip:
          type: string
        latitude:
          type: number
          format: float
        longitude:
          type: number
          format: float
    Public.PractitionerBlueprint_min:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
    Public.PhoneBlueprint_leaf:
      type: object
      properties:
        number:
          type: string
        type:
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Practice access token or Partner API key (Bearer authentication)
    hint_api_key:
      type: apiKey
      name: AUTHORIZATION
      in: header
      description: 'Enter your token in the format: `Bearer {your_api_key}`'
x-refined-from:
- hint-health-hint-health-api-openapi.yml
- hint-health-partner-endpoints-2026-07-01-openapi.yml