api-ninjas-com Hospitals API

openapi: 3.2.0
info:
  title: Ninjas Hospitals API
  description: 'Combined OpenAPI specification for every API Ninjas endpoint. Requests go to https://api.api-ninjas.com with an `X-Api-Key` header; get a free key at https://api-ninjas.com/register. Human-readable docs: https://api-ninjas.com/api. Index for LLMs: https://api-ninjas.com/llms.txt.'
  version: 1.0.0
  contact:
    name: API Ninjas
    url: https://api-ninjas.com
  license:
    name: Proprietary
servers:
- url: https://api.api-ninjas.com
  description: API Ninjas Production
security:
- ApiKeyAuth: []
tags:
- name: Hospitals
  description: The Hospitals API provides detailed information about hospitals in the United States including location, contact information, bed count, and more.
paths:
  /v1/hospitals:
    get:
      summary: Get hospital data based on given parameters
      description: Returns US hospitals matching a name, city, state, ZIP code, county or latitude/longitude bounding box, with location, contact information and bed count.
      operationId: getHospitals
      security:
      - ApiKeyAuth: []
      parameters:
      - name: name
        in: query
        description: Name of the hospital to search for. Supports partial matching.
        required: false
        schema:
          type: string
      - name: city
        in: query
        description: City where the hospital is located.
        required: false
        schema:
          type: string
      - name: state
        in: query
        description: State where the hospital is located.
        required: false
        schema:
          type: string
      - name: zipcode
        in: query
        description: ZIP code of the hospital location.
        required: false
        schema:
          type: string
      - name: county
        in: query
        description: County where the hospital is located.
        required: false
        schema:
          type: string
      - name: min_latitude
        in: query
        description: Minimum latitude coordinate.
        required: false
        schema:
          type: number
          format: float
      - name: max_latitude
        in: query
        description: Maximum latitude coordinate.
        required: false
        schema:
          type: number
          format: float
      - name: min_longitude
        in: query
        description: Minimum longitude coordinate.
        required: false
        schema:
          type: number
          format: float
      - name: max_longitude
        in: query
        description: Maximum longitude coordinate.
        required: false
        schema:
          type: number
          format: float
      - name: limit
        in: query
        description: Number of results to return. Default is 5. Maximum is 100.
        required: false
        schema:
          type: integer
          default: 5
          minimum: 1
          maximum: 100
      - name: offset
        in: query
        description: Number of results to skip. Default is 0.
        required: false
        schema:
          type: integer
          default: 0
      responses:
        '200':
          $ref: '#/components/responses/HospitalList'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      tags:
      - Hospitals
components:
  schemas:
    Hospital:
      type: object
      properties:
        name:
          type: string
          description: Name of the hospital
        care_type:
          type: string
          description: Type of care provided by the hospital
        address:
          type: string
          description: Address of the hospital
        city:
          type: string
          description: City where the hospital is located
        state:
          type: string
          description: State where the hospital is located
        zipcode:
          type: string
          description: ZIP code of the hospital location
        county:
          type: string
          description: County where the hospital is located
        location_area_code:
          type: string
          description: Area code of the hospital location
        fips_code:
          type: string
          description: FIPS code of the hospital location
        timezone:
          type: string
          description: Timezone of the hospital location
        latitude:
          type: string
          description: Latitude coordinate of the hospital
        longitude:
          type: string
          description: Longitude coordinate of the hospital
        phone_number:
          type: string
          description: Contact phone number of the hospital
        website:
          type: string
          description: Website URL of the hospital
        ownership:
          type: string
          description: Ownership type of the hospital
        bedcount:
          type: integer
          description: Number of beds available in the hospital
  responses:
    HospitalList:
      description: A list of hospitals
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/Hospital'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api