{"openapi":"3.1.0","info":{"title":"Summonable API","version":"1.0.0","description":"Read-only directory of people and services AI agents can hire. Free, no API key, rate-limited to 120 requests a minute per IP. The same data is available over MCP at https://summonable.ai/mcp."},"servers":[{"url":"https://summonable.ai/v1"}],"paths":{"/services":{"get":{"operationId":"findServices","summary":"Search listings","parameters":[{"name":"q","in":"query","required":false,"description":"Words that must appear in the listing, e.g. 'notary' or 'NDA review'","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Category key, e.g. 'legal' or 'legal.notary'","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO 3166-1 alpha-2 country code where the provider is based","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"City where the provider is based","schema":{"type":"string"}},{"name":"remote","in":"query","required":false,"description":"Only providers who work remotely","schema":{"type":"boolean"}},{"name":"max_price","in":"query","required":false,"description":"Maximum price in major units, in `currency`","schema":{"type":"number"}},{"name":"currency","in":"query","required":false,"description":"Currency for max_price (default USD)","schema":{"type":"string","enum":["USD","EUR","GBP","CAD","AUD","CHF"]}},{"name":"verified_only","in":"query","required":false,"description":"Only listings Summonable verified with a real check","schema":{"type":"boolean"}},{"name":"sort","in":"query","required":false,"description":"verified (default), price or newest","schema":{"type":"string","enum":["verified","price","newest"]}},{"name":"page","in":"query","required":false,"description":"Page number, from 1","schema":{"type":"integer"}},{"name":"per_page","in":"query","required":false,"description":"Results per page, up to 50","schema":{"type":"integer"}}],"responses":{"200":{"description":"Matching listings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResults"}}}}}}},"/services/{id}":{"get":{"operationId":"getService","summary":"Get one listing","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The listing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Service"}}}},"404":{"description":"No active listing with that id"}}}},"/categories":{"get":{"operationId":"listCategories","summary":"List categories","responses":{"200":{"description":"The category tree","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Categories"}}}}}}}},"components":{"schemas":{"Price":{"type":"object","properties":{"amount":{"type":["number","null"],"description":"Major units; null when the unit is 'quote'"},"currency":{"type":"string","enum":["USD","EUR","GBP","CAD","AUD","CHF"]},"unit":{"type":"string","enum":["per_job","per_hour","per_visit","per_word","fixed","quote"]},"from":{"type":"boolean","description":"True if the amount is a starting price"},"label":{"type":"string"}}},"Location":{"type":"object","properties":{"city":{"type":["string","null"]},"region":{"type":["string","null"]},"country":{"type":"string"},"country_name":{"type":"string"},"remote_ok":{"type":"boolean"}}},"Hire":{"type":"object","properties":{"via":{"type":"string","enum":["email","phone","url","api","mcp"]},"contact":{"type":"string"},"website":{"type":"string"},"api":{"type":"string"},"mcp":{"type":"string"}}},"ServiceSummary":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"price":{"$ref":"#/components/schemas/Price"},"location":{"$ref":"#/components/schemas/Location"},"hire":{"$ref":"#/components/schemas/Hire"},"turnaround_hours":{"type":["integer","null"]},"verified":{"type":"boolean"},"url":{"type":"string"}}},"Service":{"allOf":[{"$ref":"#/components/schemas/ServiceSummary"},{"type":"object","properties":{"category_name":{"type":"string"},"languages":{"type":"array","items":{"type":"string"}},"qualification":{"type":["string","null"]},"disclosure":{"type":["string","null"]},"verification":{"type":"object","properties":{"verified":{"type":"boolean"},"at":{"type":"string","format":"date"},"method":{"type":"string","enum":["licence_register","paid_test_job","video_call","other"]},"method_label":{"type":"string"},"notes":{"type":"string"},"method_url":{"type":"string"}}},"listed_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}}]},"SearchResults":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/ServiceSummary"}},"total":{"type":"integer"},"page":{"type":"integer"},"per_page":{"type":"integer"},"next_page":{"type":["integer","null"]}}},"Categories":{"type":"object","properties":{"categories":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"children":{"type":"array","items":{"type":"object"}}}}}}}}}}