Hark Tech Repair Services API

openapi: 3.2.0
info:
  title: Hark Tech 3D printing quotes Repair Services API
  version: 1.1.0
  summary: Look up live UK 3D printing prices for catalogue models.
  description: 'Hark Tech (Basingstoke, UK) prints catalogue models and customers'' own files and posts them across the UK. These read-only endpoints let AI assistants find a model and get its price, postage, dispatch time and an order link. Never place orders or take payment on a person''s behalf: give them order_url. Rate limit: 120 requests per 10 minutes per address. Human-readable guide: https://harktech.co.uk/for-ai-assistants.html An MCP server with the same tools is at https://harktech.co.uk/mcp. Repair endpoints (/api/repair-services, /api/repair-service-info) describe Hark Tech''s mail-in electronics repair services and policies; repairs are booked and paid by the person on harktech.co.uk.'
  contact:
    name: Hark Tech
    url: https://harktech.co.uk/contact.html
servers:
- url: https://harktech.co.uk
tags:
- name: Repair Services
paths:
  /api/repair-services:
    get:
      operationId: searchRepairServices
      summary: Match a device and fault to Hark Tech's mail-in repair services
      description: 'Returns the published mail-in repair services that fit the device and symptom, each with a fixed price (with deposit) or an assessment fee and what it covers, turnaround, warranty and a booking link. Devices Hark Tech does not repair (for example mobile phones) return in_scope false with a message. Both parameters are optional; with none, the general board-level assessment is returned. Never book or pay on a person''s behalf: give them booking_url.'
      parameters:
      - name: device
        in: query
        schema:
          type: string
          maxLength: 200
        description: The device, e.g. "Xbox Series X", "Switch OLED", "MacBook Pro 2019", "guitar amp".
      - name: symptom
        in: query
        schema:
          type: string
          maxLength: 300
        description: The fault in plain words, e.g. "overheating", "no HDMI signal", "stick drift".
      responses:
        '200':
          description: Matching services.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepairServices'
      tags:
      - Repair Services
components:
  schemas:
    RepairPricing:
      type: object
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - fixed
          - assessment
          - assessment_then_quote
          description: 'fixed: one published price. assessment: a paid assessment (e.g. controllers). assessment_then_quote: an assessment fee, then a fixed written price.'
        price_gbp:
          type: number
          description: 'fixed only: the full price, parts, labour and tracked UK return included.'
        includes:
          type: string
        deposit_gbp:
          type: number
          description: 'fixed only: paid at booking and credited against the price.'
        deposit_note:
          type: string
        extra_unit_gbp:
          type: number
        assessment_gbp:
          type: number
          description: Assessment fee, charged whether or not the item proves repairable, credited in full against a repair.
        paid_at_booking_gbp:
          type: number
        assessment_covers:
          type: string
        after_assessment:
          type: string
        typical_total:
          type: string
    RepairServices:
      type: object
      required:
      - query
      - in_scope
      - results
      properties:
        query:
          type: object
          properties:
            device:
              type: string
            symptom:
              type: string
        in_scope:
          type: boolean
          description: False when Hark Tech does not repair that kind of device; message says why.
        message:
          type: string
        results:
          type: array
          items:
            $ref: '#/components/schemas/RepairService'
        turnaround:
          type: string
        mail_in:
          type: string
        all_services:
          type: string
          format: uri
        contact:
          type: string
          format: uri
    RepairService:
      type: object
      properties:
        service:
          type: string
        device:
          type: string
        pricing:
          $ref: '#/components/schemas/RepairPricing'
        turnaround:
          type: string
        warranty:
          type: string
        how_to_book:
          type: string
        notes:
          type: string
        booking_url:
          type: string
          format: uri
          description: 'Give this to the person: they book and pay there.'
        page_url:
          type: string
          format: uri