{"openapi":"3.1.0","info":{"title":"Nuntrix public API","description":"The open, read-only corpus of Nuntrix, an open marketplace for local services: the category tree, the places, the listings (nuntios) and the businesses, as public projections. No key, no account and no envelope; every list is cursor-paginated, and calls are metered per network address and answered 429 with Retry-After when a budget is spent. Contact details are never on this API. Acting as an account — releasing a contact, posting, answering — is the MCP server's, at /api/mcp, with a registered key.","license":{"name":"Nuntrix terms","url":"https://nuntrix.com/en/legal/terms"},"version":"2026-08-26"},"servers":[{"url":"https://nuntrix.com"}],"paths":{"/api/public/v1/":{"get":{"tags":["public"],"summary":"Index of the public API","description":"Where everything is: every endpoint of this API, this schema, the page that explains it, the MCP server and the licence the corpus is published under.","operationId":"index_api_public_v1__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Index Api Public V1  Get"}}}}}}},"/api/public/v1/catalog":{"get":{"tags":["public"],"summary":"Catalog","operationId":"catalog_api_public_v1_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Catalog Api Public V1 Catalog Get"}}}}}}},"/api/public/v1/localities":{"get":{"tags":["public"],"summary":"Localities","operationId":"localities_api_public_v1_localities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Localities Api Public V1 Localities Get"}}}}}}},"/api/public/v1/nuntios":{"get":{"tags":["public"],"summary":"Nuntios","operationId":"nuntios_api_public_v1_nuntios_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"locality","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locality"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Nuntios Api Public V1 Nuntios Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/nuntios/{slug}":{"get":{"tags":["public"],"summary":"Nuntio","operationId":"nuntio_api_public_v1_nuntios__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Nuntio Api Public V1 Nuntios  Slug  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/providers":{"get":{"tags":["public"],"summary":"Providers","operationId":"providers_api_public_v1_providers_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"locality","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locality"}},{"name":"verified_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Verified Only"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Providers Api Public V1 Providers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/providers/{slug}":{"get":{"tags":["public"],"summary":"Provider","operationId":"provider_api_public_v1_providers__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Provider Api Public V1 Providers  Slug  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/v1/coverage":{"get":{"tags":["public"],"summary":"Coverage","operationId":"coverage_api_public_v1_coverage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Coverage Api Public V1 Coverage Get"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}