Hark Tech Quote API

openapi: 3.2.0
info:
  title: Hark Tech 3D printing quotes Quote 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: Quote
paths:
  /api/quote:
    get:
      operationId: getModelQuote
      summary: Price a Printables or Thingiverse model
      description: Indicative price for one copy of the model's main file, from a real slice, plus postage, lead times, batch discounts and an order link. Only models whose licence allows commercial printing are priced; others return available=false with a reason. For a person's own STL/3MF/STEP file, send them to https://harktech.co.uk/printing.html instead.
      parameters:
      - name: url
        in: query
        schema:
          type: string
        description: Printables (printables.com/model/123), Thingiverse (thingiverse.com/thing:123) or harktech.co.uk/m/ model link. Alternatively give site and id.
      - name: site
        in: query
        schema:
          type: string
          enum:
          - printables
          - thingiverse
      - name: id
        in: query
        schema:
          type: string
          pattern: ^[0-9]+$
      - name: material
        in: query
        schema:
          type: string
          default: pla
          enum:
          - pla
          - pla matte
          - pla silk
          - petg
          - tpu
          - abs
          - asa
          - pc
          - nylon
          - petg-cf
          - pa-cf
      - name: qty
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 999
          default: 1
      responses:
        '200':
          description: A quote (available=true) or an explanation why the model cannot be priced (available=false).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Quote'
        '400':
          description: Unrecognised model link or material.
        '404':
          description: Model not in the Hark Tech catalogue.
        '429':
          description: Rate limited; retry later.
        '503':
          description: Pricing busy; retry after retry_after_seconds.
      tags:
      - Quote
components:
  schemas:
    Quote:
      type: object
      properties:
        available:
          type: boolean
        summary:
          type: string
          description: One plain-English sentence suitable to repeat to the person.
        reason:
          type: string
          description: When available=false, e.g. personal_use_licence, licence_excluded, busy, too_big.
        message:
          type: string
        model:
          type: object
          properties:
            title:
              type: string
            designer:
              type: string
            source_url:
              type: string
            page_url:
              type: string
            licence:
              type: string
        material:
          type: string
        material_name:
          type: string
        price_single_copy_gbp:
          type: number
          description: Price for one copy ordered on its own.
        at_order_minimum:
          type: boolean
          description: 'True when that price is the order minimum (small part): extra copies or other small parts share it, so do not multiply by quantity. Small PLA and PETG parts use the lower small-part minimum, see order_minimum_gbp and small_part_price.'
        order_minimum_gbp:
          type: number
        priced_file:
          type: string
        price_basis:
          type: string
        quantity_requested:
          type: integer
        quantity_note:
          type:
          - string
          - 'null'
        other_materials_gbp:
          type: object
          additionalProperties:
            type: number
        batch_discounts:
          type: array
          items:
            type: object
            properties:
              min_copies:
                type: integer
              discount_pct:
                type: integer
        lead_times:
          type: object
          additionalProperties:
            type: string
        postage:
          type: object
        order_url:
          type: string
          description: Give this link to the person to review options and pay on harktech.co.uk.
        retry_after_seconds:
          type: integer
        currency:
          type: string
          const: GBP