AssistAnt 24/7 Pros API

openapi: 3.2.0
info:
  title: Assistant247 Net Pros API
  version: 1.3.0
  contact:
    url: https://assistant247.net/find
  license:
    name: Listings include Overture Maps Foundation data (CDLA-Permissive-2.0)
    url: https://cdla.dev/permissive-2-0/
  description: 'Operations tagged Pros across 2 of this provider''s published API definitions: assistant247-net-openapi.json, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://assistant247.net
tags:
- name: Pros
paths:
  /api/pros:
    get:
      operationId: findPros
      summary: 'Find local service businesses (39 trades: appliance repair, HVAC, plumbers…'
      description: 'Returns businesses ordered verified-first, then by match and distance. If a problem is given, free repair guides that match come back first (help before a sales call). Never a dead end: for appliance services, when nothing is within 40 miles a nationwide video-diagnosis option is returned; for every other trade, an honest note says how far the closest listed business is. brand, appliance and problem apply to appliance services only. An unknown service is a 400 that lists the valid ones.'
      parameters:
      - name: zip
        in: query
        schema:
          type: string
          pattern: ^\d{5}$
        description: 5-digit U.S. ZIP code (or give lat and lon)
      - name: lat
        in: query
        schema:
          type: number
      - name: lon
        in: query
        schema:
          type: number
      - name: service
        in: query
        schema:
          type: string
          enum:
          - appliance_repair
          - dryer_vent_cleaning
          - used_appliances
          - appliance_store
          - duct_cleaning
          - hvac
          - plumbing
          - electrical
          - roofing
          - landscaping
          - cleaning
          - pest_control
          - locksmith
          - painting
          - garage_door
          - handyman
          - pool_spa
          - restoration
          - concrete_masonry
          - fence
          - gutters
          - septic
          - chimney
          - junk_removal
          - home_inspection
          - flooring
          - windows_doors
          - security_systems
          - remodeling
          - insulation
          - solar
          - well_drilling
          - towing
          - auto_repair
          - collision
          - diesel_truck
          - power_sports
          - welding
          - machine_shop
          - computer_repair
          - heavy_equipment
          - trucking
          - aquarium
          default: appliance_repair
        description: What the person needs. appliance_repair = Appliance repair; dryer_vent_cleaning = Dryer vent cleaning; used_appliances = Used & scratch-and-dent appliances; appliance_store = Appliance store; duct_cleaning = Air duct cleaning; hvac = Heating & air conditioning (HVAC); plumbing = Plumbing; electrical = Electrical; roofing = Roofing; landscaping = Landscaping, lawn, tree service companies; cleaning = Cleaning (home, office, carpet, pressure washing); pest_control = Pest control; locksmith = Locksmith; painting = Painting; garage_door = Garage door repair; handyman = Handyman; pool_spa = Pool & spa service; restoration = Water, fire & mold restoration; concrete_masonry = Concrete, masonry & paving; fence = Fencing; gutters = Gutters; septic = Septic service; chimney = Chimney sweep & repair; junk_removal = Junk removal; home_inspection = Home inspection; flooring = Flooring; windows_doors = Windows & doors; security_systems = Home security systems; remodeling = Remodeling; insulation = Insulation; solar = Solar installation; well_drilling = Well drilling & pumps; towing = Towing & roadside; auto_repair = Auto repair; collision = Collision & auto glass; diesel_truck = Diesel & truck repair; power_sports = Motorcycle, marine & small engine; welding = Welding & fabrication; machine_shop = Machine shops & CNC; computer_repair = Computer & phone repair / IT; heavy_equipment = Excavation & heavy equipment; trucking = Trucking; aquarium = Aquarium service & fish.
      - name: brand
        in: query
        schema:
          type: string
        description: e.g. samsung, lg, whirlpool, ge, sub-zero, viking, speed-queen
      - name: appliance
        in: query
        schema:
          type: string
          enum:
          - refrigerator
          - freezer
          - ice_maker
          - washer
          - dryer
          - dishwasher
          - oven_range
          - microwave
          - wine_cooler
          - disposal
      - name: problem
        in: query
        schema:
          type: string
        description: What is wrong, in plain words, including any error code
      - name: segment
        in: query
        schema:
          type: string
          enum:
          - residential
          - commercial
          default: residential
      - name: lang
        in: query
        schema:
          type: string
          enum:
          - en
          - es
      tags:
      - Pros
    servers:
    - url: https://assistant247.net
  /pros/{slug}:
    get:
      operationId: getProProfile
      summary: One business's full listing
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
        description: Last part of the profile URL
      - name: format
        in: query
        required: true
        schema:
          type: string
          enum:
          - json
      responses:
        '200':
          description: Profile
          content:
            application/json:
              schema:
                type: object
        '404':
          description: No such listing
        '410':
          description: Removed at the business's request
      tags:
      - Pros
    servers:
    - url: https://assistant247.net
components:
  schemas:
    Pro:
      type: object
      properties:
        name:
          type: string
        services:
          type: array
          items:
            type: string
        brands_named:
          type: array
          items:
            type: string
        appliances_named:
          type: array
          items:
            type: string
        trust:
          type: object
          properties:
            tier:
              type: string
              enum:
              - listed
              - verified_public
              - verified_data
            label:
              type: string
            claimed_by_business:
              type: boolean
            verified_on:
              type: string
              format: date
        bookable_online:
          type: boolean
        phone:
          type:
          - string
          - 'null'
        website:
          type:
          - string
          - 'null'
        distance_miles:
          type: number
        profile:
          type: string
          format: uri
        trust_card:
          type: string
          format: uri
          description: 'AssistAnt Trust Card (JSON): every fact we verified about this business, how and when, plus what is not verified yet.'
    SearchResult:
      type: object
      properties:
        ok:
          type: boolean
        free_help_first:
          type: object
          description: Matching free repair guides, shown before any business
        no_pro_nearby:
          type: object
        privacy:
          type: string
        results:
          type: array
          items:
            $ref: '#/components/schemas/Pro'
        ranking:
          type: string
        how_we_verify:
          type: string
          format: uri
x-refined-from:
- assistant247-net-openapi.json
- openapi.json