handlediq-com Verify Record API

openapi: 3.2.0
info:
  title: 'HandledIQ: find and book home service Verify Record API'
  version: 1.4.1
  description: 'HandledIQ runs home service shops (heating and cooling, plumbing, electrical, roofing, pest control, junk removal, demolition and more). For a person''s own AI assistant: find_help with what they need and their ZIP finds the shops near them that do it, each with its own book price, all in, its soonest real open time and its signed record (work finished, callbacks, arrivals kept, ratings). hold_time holds one shop''s time for 10 minutes and that shop texts the person a link; the visit is booked only when the person books it on the shop''s page, never on your word. booking_status says whether they did. Once booked, move_booking has the shop text the person a link to pick a new time, and cancel_booking cancels for free within 3 days of booking, before the visit. Every price is all in, paid after the work. request_service with a shop''s business_id opens HandledIQ''s quote window on it, where the person does the same themselves; get_quote gives one shop''s price and times by its business_id. The same calls speak MCP at https://app.handlediq.com/agents/mcp.'
servers:
- url: https://app.handlediq.com/agents
tags:
- name: Verify Record
paths:
  /api/verify_record:
    post:
      operationId: verify_record
      summary: Check a signed record
      description: 'Checks a signed record from any HandledIQ shop (a house''s, a technician''s or a shop''s): valid, with who signed it and the record it holds, or not valid and why. Anyone can make the same check with the key at the issuer''s id.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                signed:
                  type: string
                  description: 'The signed form a record came with (signed, or signed_record): a compact JWS, up to a million characters.'
              required:
              - signed
              additionalProperties: false
      responses:
        '200':
          description: Answered.
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    ok:
                      const: true
                  required:
                  - ok
                - type: object
                  properties:
                    valid:
                      type: boolean
                    trusted:
                      type: boolean
                    key_status:
                      type: string
                    issuer:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                    record:
                      type: object
                    why:
                      type: string
                  required:
                  - valid
        '400':
          description: The arguments were not a JSON object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Failure'
        '404':
          description: No such quote or shop.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Failure'
        '409':
          description: 'Not now: the quote''s state or the time changed.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Failure'
        '422':
          description: An argument to fix; the error says which.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Failure'
        '429':
          description: Too many calls; the error says when to come back.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Failure'
      tags:
      - Verify Record
components:
  schemas:
    Failure:
      type: object
      properties:
        ok:
          const: false
        error:
          type: string
      required:
      - ok
      - error