{
  "openapi": "3.1.0",
  "info": {
    "title": "Remodel Your Vibe API",
    "version": "1.0.0",
    "summary": "Read-only public API for a Southern California design-build remodeling company.",
    "description": "Services, typical price ranges, service areas and site search for Remodel Your Vibe, a licensed residential design-build company serving Greater Los Angeles and Orange County.\n\n**Authentication.** None. The API is public and read-only: no API key, no OAuth, no sign-up. Send plain GET requests.\n\n**Rate limits.** 120 requests per 60 seconds per IP address. Every response carries RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset and RateLimit-Policy headers. Past the limit the API answers 429 with a Retry-After header.\n\n**Pagination.** List endpoints are cursor-based. They take `limit` and `cursor` and return `data`, `has_more` and `next_cursor`. Pass `next_cursor` back unchanged as `cursor` to read the next page.\n\n**Errors.** Every error is an RFC 9457 problem document (`application/problem+json`) with a stable `code`, a human-readable `detail` and a `hint` that says how to fix the request.\n\n**Versioning.** The major version is part of the path (/api/v1). Within a major version changes are additive only: new endpoints, new optional parameters and new response fields. Clients must ignore fields they do not know.\n\n**Deprecation and sunset policy.** A breaking change ships as a new major version (/api/v2). The previous version keeps working for at least 12 months after its successor is published. During that time its responses carry Deprecation and Sunset headers (RFC 9745, RFC 8594) with the retirement date, and the change is announced on the docs page. Full policy: https://www.remodelyourvibe.com/docs/deprecation-policy\n\n**Sandbox.** A sandbox environment is available at https://www.remodelyourvibe.com/api/sandbox/v1. It has the same endpoints, parameters and response shapes as production, needs no key, and has its own rate limit, so integration tests and experiments never count against production traffic. Sandbox responses carry the header X-RYV-Environment: sandbox. The API is read-only in both environments, so no call can change data.\n\n**Prices.** Figures are planning ranges in US dollars, not quotes. A written line-item proposal after a site visit sets the price of a project.\n\n**Model Context Protocol.** The same content is available to MCP clients at https://www.remodelyourvibe.com/mcp.",
    "termsOfService": "https://www.remodelyourvibe.com/terms",
    "contact": {
      "name": "Remodel Your Vibe",
      "url": "https://www.remodelyourvibe.com/docs",
      "email": "office@remodelyourvibe.com"
    }
  },
  "externalDocs": {
    "description": "API guide, MCP server and in-page WebMCP tools",
    "url": "https://www.remodelyourvibe.com/docs"
  },
  "servers": [
    {
      "url": "https://www.remodelyourvibe.com/api",
      "description": "Production"
    },
    {
      "url": "https://www.remodelyourvibe.com/api/sandbox",
      "description": "Sandbox: same endpoints and response shapes, separate rate limit, for testing"
    }
  ],
  "x-sandbox": {
    "url": "https://www.remodelyourvibe.com/api/sandbox/v1",
    "authentication": "none",
    "description": "A sandbox environment is available at https://www.remodelyourvibe.com/api/sandbox/v1. It has the same endpoints, parameters and response shapes as production, needs no key, and has its own rate limit, so integration tests and experiments never count against production traffic. Sandbox responses carry the header X-RYV-Environment: sandbox. The API is read-only in both environments, so no call can change data."
  },
  "x-api-lifecycle": {
    "status": "stable",
    "version": "1.0.0",
    "versioning": "url-path-major",
    "deprecated": false,
    "sunset": null,
    "deprecationPolicy": "https://www.remodelyourvibe.com/docs/deprecation-policy",
    "minimumDeprecationNoticeMonths": 12,
    "signals": [
      "Deprecation header (RFC 9745)",
      "Sunset header (RFC 8594)",
      "Link rel=deprecation"
    ]
  },
  "security": [],
  "tags": [
    {
      "name": "Business",
      "description": "Who the company is and how to reach it."
    },
    {
      "name": "Services",
      "description": "What the company designs and builds."
    },
    {
      "name": "Pricing",
      "description": "Typical price ranges by project type."
    },
    {
      "name": "Service areas",
      "description": "Where the company works."
    },
    {
      "name": "Search",
      "description": "Find any published page."
    }
  ],
  "paths": {
    "/v1": {
      "get": {
        "operationId": "getApiIndex",
        "tags": [
          "Business"
        ],
        "summary": "API index",
        "description": "Describes this API: its version, documentation, rate limit and the list of endpoints. Start here when exploring.",
        "responses": {
          "200": {
            "description": "The API index.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiIndex"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameter. A query parameter is missing or out of range; the problem names it and says how to fix it.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-invalid-parameter",
                  "title": "Invalid parameter",
                  "status": 400,
                  "detail": "\"limit\" must be a whole number from 1 to 100.",
                  "code": "invalid_parameter",
                  "hint": "Send limit=20, or leave it out for the default.",
                  "parameter": "limit",
                  "instance": "/api/v1/services",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "404": {
            "description": "Not found. No resource has that id, or the path is not an endpoint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-not-found",
                  "title": "Not found",
                  "status": 404,
                  "detail": "There is no service with the id \"roofing\".",
                  "code": "not_found",
                  "hint": "List the valid ids at https://www.remodelyourvibe.com/api/v1/services.",
                  "instance": "/api/v1/services/roofing",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit reached. Wait for the number of seconds in Retry-After, then retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-rate-limited",
                  "title": "Rate limit reached",
                  "status": 429,
                  "detail": "More than 120 requests in 60 seconds.",
                  "code": "rate_limited",
                  "hint": "Wait 30 seconds (see the Retry-After header), then retry.",
                  "retry_after_seconds": 30,
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "500": {
            "description": "Internal error. An unexpected error on the server; safe to retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-internal-error",
                  "title": "Internal error",
                  "status": 500,
                  "detail": "Something went wrong on our side.",
                  "code": "internal_error",
                  "hint": "Retry shortly. If it keeps failing, email us with the request_id.",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "default": {
            "description": "Any other error. Always a Problem document with a stable code and a hint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/business": {
      "get": {
        "operationId": "getBusiness",
        "tags": [
          "Business"
        ],
        "summary": "Get business details",
        "description": "Returns the company name, phone, email, address, opening hours, contractor license and service footprint. Use it to answer contact or licensing questions.",
        "responses": {
          "200": {
            "description": "The business profile.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Business"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameter. A query parameter is missing or out of range; the problem names it and says how to fix it.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-invalid-parameter",
                  "title": "Invalid parameter",
                  "status": 400,
                  "detail": "\"limit\" must be a whole number from 1 to 100.",
                  "code": "invalid_parameter",
                  "hint": "Send limit=20, or leave it out for the default.",
                  "parameter": "limit",
                  "instance": "/api/v1/services",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "404": {
            "description": "Not found. No resource has that id, or the path is not an endpoint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-not-found",
                  "title": "Not found",
                  "status": 404,
                  "detail": "There is no service with the id \"roofing\".",
                  "code": "not_found",
                  "hint": "List the valid ids at https://www.remodelyourvibe.com/api/v1/services.",
                  "instance": "/api/v1/services/roofing",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit reached. Wait for the number of seconds in Retry-After, then retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-rate-limited",
                  "title": "Rate limit reached",
                  "status": 429,
                  "detail": "More than 120 requests in 60 seconds.",
                  "code": "rate_limited",
                  "hint": "Wait 30 seconds (see the Retry-After header), then retry.",
                  "retry_after_seconds": 30,
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "500": {
            "description": "Internal error. An unexpected error on the server; safe to retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-internal-error",
                  "title": "Internal error",
                  "status": 500,
                  "detail": "Something went wrong on our side.",
                  "code": "internal_error",
                  "hint": "Retry shortly. If it keeps failing, email us with the request_id.",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "default": {
            "description": "Any other error. Always a Problem document with a stable code and a hint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/services": {
      "get": {
        "operationId": "listServices",
        "tags": [
          "Services"
        ],
        "summary": "List services",
        "description": "Returns the services the company offers, each with a summary and links to its web page and its detail endpoint.",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return in one page. Defaults to 20.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of services.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "One page of a list. Follow next_cursor until has_more is false.",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ServiceSummary"
                      },
                      "description": "The items on this page."
                    },
                    "has_more": {
                      "type": "boolean",
                      "description": "True when more items follow this page."
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Pass as the cursor parameter to get the next page. Null on the last page."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameter. A query parameter is missing or out of range; the problem names it and says how to fix it.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-invalid-parameter",
                  "title": "Invalid parameter",
                  "status": 400,
                  "detail": "\"limit\" must be a whole number from 1 to 100.",
                  "code": "invalid_parameter",
                  "hint": "Send limit=20, or leave it out for the default.",
                  "parameter": "limit",
                  "instance": "/api/v1/services",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "404": {
            "description": "Not found. No resource has that id, or the path is not an endpoint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-not-found",
                  "title": "Not found",
                  "status": 404,
                  "detail": "There is no service with the id \"roofing\".",
                  "code": "not_found",
                  "hint": "List the valid ids at https://www.remodelyourvibe.com/api/v1/services.",
                  "instance": "/api/v1/services/roofing",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit reached. Wait for the number of seconds in Retry-After, then retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-rate-limited",
                  "title": "Rate limit reached",
                  "status": 429,
                  "detail": "More than 120 requests in 60 seconds.",
                  "code": "rate_limited",
                  "hint": "Wait 30 seconds (see the Retry-After header), then retry.",
                  "retry_after_seconds": 30,
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "500": {
            "description": "Internal error. An unexpected error on the server; safe to retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-internal-error",
                  "title": "Internal error",
                  "status": 500,
                  "detail": "Something went wrong on our side.",
                  "code": "internal_error",
                  "hint": "Retry shortly. If it keeps failing, email us with the request_id.",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "default": {
            "description": "Any other error. Always a Problem document with a stable code and a hint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/services/{service_id}": {
      "get": {
        "operationId": "getService",
        "tags": [
          "Services"
        ],
        "summary": "Get one service",
        "description": "Returns one service in detail: benefits, design options, planning and timeline notes, frequently asked questions and its typical price ranges.",
        "parameters": [
          {
            "name": "service_id",
            "in": "path",
            "required": true,
            "description": "The service id, as returned by listServices.",
            "schema": {
              "type": "string",
              "enum": [
                "swimming-pool-spa",
                "exterior-remodeling",
                "adus-additions",
                "interior-remodeling",
                "3d-design",
                "plans-permits"
              ]
            },
            "example": "swimming-pool-spa"
          }
        ],
        "responses": {
          "200": {
            "description": "The service.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Service"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameter. A query parameter is missing or out of range; the problem names it and says how to fix it.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-invalid-parameter",
                  "title": "Invalid parameter",
                  "status": 400,
                  "detail": "\"limit\" must be a whole number from 1 to 100.",
                  "code": "invalid_parameter",
                  "hint": "Send limit=20, or leave it out for the default.",
                  "parameter": "limit",
                  "instance": "/api/v1/services",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "404": {
            "description": "Not found. No resource has that id, or the path is not an endpoint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-not-found",
                  "title": "Not found",
                  "status": 404,
                  "detail": "There is no service with the id \"roofing\".",
                  "code": "not_found",
                  "hint": "List the valid ids at https://www.remodelyourvibe.com/api/v1/services.",
                  "instance": "/api/v1/services/roofing",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit reached. Wait for the number of seconds in Retry-After, then retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-rate-limited",
                  "title": "Rate limit reached",
                  "status": 429,
                  "detail": "More than 120 requests in 60 seconds.",
                  "code": "rate_limited",
                  "hint": "Wait 30 seconds (see the Retry-After header), then retry.",
                  "retry_after_seconds": 30,
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "500": {
            "description": "Internal error. An unexpected error on the server; safe to retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-internal-error",
                  "title": "Internal error",
                  "status": 500,
                  "detail": "Something went wrong on our side.",
                  "code": "internal_error",
                  "hint": "Retry shortly. If it keeps failing, email us with the request_id.",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "default": {
            "description": "Any other error. Always a Problem document with a stable code and a hint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/pricing": {
      "get": {
        "operationId": "listPriceRanges",
        "tags": [
          "Pricing"
        ],
        "summary": "List typical price ranges",
        "description": "Returns typical Southern California price ranges by project type, with the low and high figures in US dollars and what moves each number. Planning estimates, not quotes.",
        "parameters": [
          {
            "name": "service_id",
            "in": "query",
            "required": false,
            "description": "Only return the ranges that belong to this service.",
            "schema": {
              "type": "string",
              "enum": [
                "swimming-pool-spa",
                "exterior-remodeling",
                "adus-additions",
                "interior-remodeling",
                "3d-design",
                "plans-permits"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return in one page. Defaults to 50.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of price ranges.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "One page of a list. Follow next_cursor until has_more is false.",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PriceRange"
                      },
                      "description": "The items on this page."
                    },
                    "has_more": {
                      "type": "boolean",
                      "description": "True when more items follow this page."
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Pass as the cursor parameter to get the next page. Null on the last page."
                    },
                    "currency": {
                      "type": "string",
                      "const": "USD",
                      "description": "ISO 4217 currency of every figure."
                    },
                    "note": {
                      "type": "string",
                      "description": "How to read these figures."
                    },
                    "url": {
                      "type": "string",
                      "format": "uri",
                      "description": "The pricing page on the website."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor",
                    "currency",
                    "note",
                    "url"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameter. A query parameter is missing or out of range; the problem names it and says how to fix it.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-invalid-parameter",
                  "title": "Invalid parameter",
                  "status": 400,
                  "detail": "\"limit\" must be a whole number from 1 to 100.",
                  "code": "invalid_parameter",
                  "hint": "Send limit=20, or leave it out for the default.",
                  "parameter": "limit",
                  "instance": "/api/v1/services",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "404": {
            "description": "Not found. No resource has that id, or the path is not an endpoint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-not-found",
                  "title": "Not found",
                  "status": 404,
                  "detail": "There is no service with the id \"roofing\".",
                  "code": "not_found",
                  "hint": "List the valid ids at https://www.remodelyourvibe.com/api/v1/services.",
                  "instance": "/api/v1/services/roofing",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit reached. Wait for the number of seconds in Retry-After, then retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-rate-limited",
                  "title": "Rate limit reached",
                  "status": 429,
                  "detail": "More than 120 requests in 60 seconds.",
                  "code": "rate_limited",
                  "hint": "Wait 30 seconds (see the Retry-After header), then retry.",
                  "retry_after_seconds": 30,
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "500": {
            "description": "Internal error. An unexpected error on the server; safe to retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-internal-error",
                  "title": "Internal error",
                  "status": 500,
                  "detail": "Something went wrong on our side.",
                  "code": "internal_error",
                  "hint": "Retry shortly. If it keeps failing, email us with the request_id.",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "default": {
            "description": "Any other error. Always a Problem document with a stable code and a hint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/service-areas": {
      "get": {
        "operationId": "listServiceAreas",
        "tags": [
          "Service areas"
        ],
        "summary": "List service areas",
        "description": "Returns the cities the company serves that have a dedicated page, in alphabetical order. Filter by name with q to check a single city. A city that is not listed is not a confirmed service area.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Only return cities whose name contains this text. Case-insensitive.",
            "schema": {
              "type": "string",
              "maxLength": 80
            },
            "example": "Encino"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return in one page. Defaults to 50.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of service areas.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "One page of a list. Follow next_cursor until has_more is false.",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ServiceAreaSummary"
                      },
                      "description": "The items on this page."
                    },
                    "has_more": {
                      "type": "boolean",
                      "description": "True when more items follow this page."
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Pass as the cursor parameter to get the next page. Null on the last page."
                    },
                    "footprint": {
                      "type": "string",
                      "description": "The whole service footprint in one sentence."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor",
                    "footprint"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameter. A query parameter is missing or out of range; the problem names it and says how to fix it.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-invalid-parameter",
                  "title": "Invalid parameter",
                  "status": 400,
                  "detail": "\"limit\" must be a whole number from 1 to 100.",
                  "code": "invalid_parameter",
                  "hint": "Send limit=20, or leave it out for the default.",
                  "parameter": "limit",
                  "instance": "/api/v1/services",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "404": {
            "description": "Not found. No resource has that id, or the path is not an endpoint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-not-found",
                  "title": "Not found",
                  "status": 404,
                  "detail": "There is no service with the id \"roofing\".",
                  "code": "not_found",
                  "hint": "List the valid ids at https://www.remodelyourvibe.com/api/v1/services.",
                  "instance": "/api/v1/services/roofing",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit reached. Wait for the number of seconds in Retry-After, then retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-rate-limited",
                  "title": "Rate limit reached",
                  "status": 429,
                  "detail": "More than 120 requests in 60 seconds.",
                  "code": "rate_limited",
                  "hint": "Wait 30 seconds (see the Retry-After header), then retry.",
                  "retry_after_seconds": 30,
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "500": {
            "description": "Internal error. An unexpected error on the server; safe to retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-internal-error",
                  "title": "Internal error",
                  "status": 500,
                  "detail": "Something went wrong on our side.",
                  "code": "internal_error",
                  "hint": "Retry shortly. If it keeps failing, email us with the request_id.",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "default": {
            "description": "Any other error. Always a Problem document with a stable code and a hint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/service-areas/{area_id}": {
      "get": {
        "operationId": "getServiceArea",
        "tags": [
          "Service areas"
        ],
        "summary": "Get one service area",
        "description": "Returns one city: the department that issues its building permits, its neighborhoods and the local service pages published for it.",
        "parameters": [
          {
            "name": "area_id",
            "in": "path",
            "required": true,
            "description": "The service-area id, as returned by listServiceAreas.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9-]+$"
            },
            "example": "encino"
          }
        ],
        "responses": {
          "200": {
            "description": "The service area.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceArea"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameter. A query parameter is missing or out of range; the problem names it and says how to fix it.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-invalid-parameter",
                  "title": "Invalid parameter",
                  "status": 400,
                  "detail": "\"limit\" must be a whole number from 1 to 100.",
                  "code": "invalid_parameter",
                  "hint": "Send limit=20, or leave it out for the default.",
                  "parameter": "limit",
                  "instance": "/api/v1/services",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "404": {
            "description": "Not found. No resource has that id, or the path is not an endpoint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-not-found",
                  "title": "Not found",
                  "status": 404,
                  "detail": "There is no service with the id \"roofing\".",
                  "code": "not_found",
                  "hint": "List the valid ids at https://www.remodelyourvibe.com/api/v1/services.",
                  "instance": "/api/v1/services/roofing",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit reached. Wait for the number of seconds in Retry-After, then retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-rate-limited",
                  "title": "Rate limit reached",
                  "status": 429,
                  "detail": "More than 120 requests in 60 seconds.",
                  "code": "rate_limited",
                  "hint": "Wait 30 seconds (see the Retry-After header), then retry.",
                  "retry_after_seconds": 30,
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "500": {
            "description": "Internal error. An unexpected error on the server; safe to retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-internal-error",
                  "title": "Internal error",
                  "status": 500,
                  "detail": "Something went wrong on our side.",
                  "code": "internal_error",
                  "hint": "Retry shortly. If it keeps failing, email us with the request_id.",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "default": {
            "description": "Any other error. Always a Problem document with a stable code and a hint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/search": {
      "get": {
        "operationId": "searchSite",
        "tags": [
          "Search"
        ],
        "summary": "Search the website",
        "description": "Searches every published page (services, service-by-city pages, service areas and remodeling articles) and returns matching titles, URLs and summaries, best match first.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Keywords to look for.",
            "schema": {
              "type": "string",
              "minLength": 2,
              "maxLength": 200
            },
            "example": "pool remodel cost"
          },
          {
            "name": "section",
            "in": "query",
            "required": false,
            "description": "Only search one part of the site.",
            "schema": {
              "type": "string",
              "enum": [
                "pages",
                "services",
                "services-by-city",
                "service-areas",
                "articles"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return in one page. Defaults to 10.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 10
            }
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of search results.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "One page of a list. Follow next_cursor until has_more is false.",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SearchResult"
                      },
                      "description": "The items on this page."
                    },
                    "has_more": {
                      "type": "boolean",
                      "description": "True when more items follow this page."
                    },
                    "next_cursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Pass as the cursor parameter to get the next page. Null on the last page."
                    },
                    "query": {
                      "type": "string",
                      "description": "The query that was searched."
                    }
                  },
                  "required": [
                    "data",
                    "has_more",
                    "next_cursor",
                    "query"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameter. A query parameter is missing or out of range; the problem names it and says how to fix it.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-invalid-parameter",
                  "title": "Invalid parameter",
                  "status": 400,
                  "detail": "\"limit\" must be a whole number from 1 to 100.",
                  "code": "invalid_parameter",
                  "hint": "Send limit=20, or leave it out for the default.",
                  "parameter": "limit",
                  "instance": "/api/v1/services",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "404": {
            "description": "Not found. No resource has that id, or the path is not an endpoint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-not-found",
                  "title": "Not found",
                  "status": 404,
                  "detail": "There is no service with the id \"roofing\".",
                  "code": "not_found",
                  "hint": "List the valid ids at https://www.remodelyourvibe.com/api/v1/services.",
                  "instance": "/api/v1/services/roofing",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit reached. Wait for the number of seconds in Retry-After, then retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              },
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-rate-limited",
                  "title": "Rate limit reached",
                  "status": 429,
                  "detail": "More than 120 requests in 60 seconds.",
                  "code": "rate_limited",
                  "hint": "Wait 30 seconds (see the Retry-After header), then retry.",
                  "retry_after_seconds": 30,
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "500": {
            "description": "Internal error. An unexpected error on the server; safe to retry.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                },
                "example": {
                  "type": "https://www.remodelyourvibe.com/docs#error-internal-error",
                  "title": "Internal error",
                  "status": 500,
                  "detail": "Something went wrong on our side.",
                  "code": "internal_error",
                  "hint": "Retry shortly. If it keeps failing, email us with the request_id.",
                  "documentation_url": "https://www.remodelyourvibe.com/docs"
                }
              }
            }
          },
          "default": {
            "description": "Any other error. Always a Problem document with a stable code and a hint.",
            "headers": {
              "RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit-Limit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              },
              "Deprecation": {
                "$ref": "#/components/headers/Deprecation"
              },
              "Sunset": {
                "$ref": "#/components/headers/Sunset"
              },
              "Link": {
                "$ref": "#/components/headers/Link"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "Cursor": {
        "name": "cursor",
        "in": "query",
        "required": false,
        "description": "The next_cursor value from the previous page. Leave out to start from the first page.",
        "schema": {
          "type": "string"
        }
      }
    },
    "headers": {
      "RateLimit-Limit": {
        "description": "Requests allowed per window.",
        "schema": {
          "type": "integer"
        },
        "example": 120
      },
      "RateLimit-Remaining": {
        "description": "Requests left in the current window.",
        "schema": {
          "type": "integer"
        },
        "example": 119
      },
      "RateLimit-Reset": {
        "description": "Seconds until the window resets.",
        "schema": {
          "type": "integer"
        },
        "example": 60
      },
      "RateLimit-Policy": {
        "description": "The quota policy: limit and window in seconds.",
        "schema": {
          "type": "string"
        },
        "example": "120;w=60"
      },
      "Retry-After": {
        "description": "Seconds to wait before retrying.",
        "schema": {
          "type": "integer"
        },
        "example": 30
      },
      "X-Request-Id": {
        "description": "Unique id of this request. Quote it when reporting a problem.",
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "Deprecation": {
        "description": "Sent only once this API version is deprecated (RFC 9745): the date it was deprecated. Absent on a current version.",
        "required": false,
        "schema": {
          "type": "string"
        },
        "example": "@1798761600"
      },
      "Sunset": {
        "description": "Sent only once this API version is deprecated (RFC 8594): the date it stops working, at least 12 months after its successor is published.",
        "required": false,
        "schema": {
          "type": "string"
        },
        "example": "Sat, 31 Dec 2028 23:59:59 GMT"
      },
      "Link": {
        "description": "Links to the documentation (rel=service-doc), this description (rel=service-desc) and the deprecation policy (rel=deprecation).",
        "schema": {
          "type": "string"
        }
      }
    },
    "schemas": {
      "Problem": {
        "type": "object",
        "description": "An error, as an RFC 9457 problem document.",
        "properties": {
          "type": {
            "type": "string",
            "format": "uri",
            "description": "A URI that identifies the kind of error and links to its documentation."
          },
          "title": {
            "type": "string",
            "description": "Short name of the kind of error."
          },
          "status": {
            "type": "integer",
            "description": "The HTTP status code."
          },
          "detail": {
            "type": "string",
            "description": "What went wrong with this request."
          },
          "code": {
            "type": "string",
            "enum": [
              "not_found",
              "invalid_parameter",
              "method_not_allowed",
              "rate_limited",
              "internal_error"
            ],
            "description": "Stable machine-readable error code. Branch on this, not on the text."
          },
          "hint": {
            "type": "string",
            "description": "How to fix the request."
          },
          "parameter": {
            "type": "string",
            "description": "The parameter at fault, for invalid_parameter."
          },
          "retry_after_seconds": {
            "type": "integer",
            "description": "Seconds to wait, for rate_limited."
          },
          "instance": {
            "type": "string",
            "description": "The path that was requested."
          },
          "request_id": {
            "type": "string",
            "description": "Unique id of the request."
          },
          "documentation_url": {
            "type": "string",
            "format": "uri",
            "description": "Where the API is documented."
          }
        },
        "required": [
          "type",
          "title",
          "status",
          "detail",
          "code",
          "hint"
        ]
      },
      "ApiIndex": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "version": {
            "type": "string",
            "description": "Semantic version of the API."
          },
          "description": {
            "type": "string"
          },
          "documentation_url": {
            "type": "string",
            "format": "uri"
          },
          "openapi_url": {
            "type": "string",
            "format": "uri"
          },
          "mcp_url": {
            "type": "string",
            "format": "uri",
            "description": "The MCP server that offers the same content."
          },
          "authentication": {
            "type": "string",
            "const": "none"
          },
          "rate_limit": {
            "type": "string"
          },
          "endpoints": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "method": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                }
              },
              "required": [
                "method",
                "url",
                "description"
              ]
            }
          }
        },
        "required": [
          "name",
          "version",
          "documentation_url",
          "openapi_url",
          "authentication",
          "endpoints"
        ]
      },
      "Business": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "phone": {
            "type": "string"
          },
          "email": {
            "type": "string",
            "format": "email"
          },
          "address": {
            "type": "string"
          },
          "hours": {
            "type": "string",
            "description": "Opening hours, in Pacific Time."
          },
          "license": {
            "type": "string",
            "description": "California contractor license."
          },
          "licenseLookup": {
            "type": "string",
            "format": "uri",
            "description": "Official license record."
          },
          "serviceArea": {
            "type": "string"
          },
          "website": {
            "type": "string",
            "format": "uri"
          },
          "consultation": {
            "type": "string",
            "format": "uri",
            "description": "Where a person requests a free consultation."
          },
          "responsePromise": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "phone",
          "email",
          "address",
          "hours",
          "license",
          "serviceArea",
          "website",
          "consultation"
        ]
      },
      "ServiceSummary": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "swimming-pool-spa",
              "exterior-remodeling",
              "adus-additions",
              "interior-remodeling",
              "3d-design",
              "plans-permits"
            ],
            "description": "Stable id of the service."
          },
          "name": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The service's page on the website."
          },
          "api_url": {
            "type": "string",
            "format": "uri",
            "description": "The detail endpoint for this service."
          }
        },
        "required": [
          "id",
          "name",
          "summary",
          "url",
          "api_url"
        ]
      },
      "Service": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ServiceSummary"
          },
          {
            "type": "object",
            "properties": {
              "benefits": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "design_options": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "planning_notes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "timeline_notes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "faqs": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "question": {
                      "type": "string"
                    },
                    "answer": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "question",
                    "answer"
                  ]
                }
              },
              "price_ranges": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PriceRange"
                }
              },
              "pricing_note": {
                "type": "string"
              }
            },
            "required": [
              "benefits",
              "faqs",
              "price_ranges"
            ]
          }
        ]
      },
      "PriceRange": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "new-pool",
              "pool-remodel",
              "backyard-transformation",
              "outdoor-kitchen",
              "paver-patio",
              "pergola",
              "turf",
              "adu",
              "garage-conversion",
              "kitchen-remodel",
              "bathroom-remodel",
              "whole-home",
              "plans-permits",
              "retaining-wall",
              "landscape-lighting"
            ],
            "description": "Stable id of the project type."
          },
          "label": {
            "type": "string",
            "description": "The project type."
          },
          "range": {
            "type": "string",
            "description": "The range as the website prints it.",
            "example": "$70,000 to $150,000+"
          },
          "low_usd": {
            "type": "number",
            "description": "Lowest typical figure, in US dollars."
          },
          "high_usd": {
            "type": [
              "number",
              "null"
            ],
            "description": "Highest typical figure. Null when the range is open-ended."
          },
          "unit": {
            "type": "string",
            "description": "What the figure is per: \"project\", or a unit such as \"face foot\"."
          },
          "drivers": {
            "type": "string",
            "description": "What moves the price within the range."
          },
          "service_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "The service this range belongs to."
          }
        },
        "required": [
          "id",
          "label",
          "range",
          "low_usd",
          "high_usd",
          "unit",
          "drivers"
        ]
      },
      "ServiceAreaSummary": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Stable id of the city."
          },
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "api_url": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "id",
          "name",
          "url",
          "api_url"
        ]
      },
      "ServiceArea": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ServiceAreaSummary"
          },
          {
            "type": "object",
            "properties": {
              "served": {
                "type": "boolean",
                "description": "Always true: only served cities have a record."
              },
              "permit_authority": {
                "type": "string",
                "description": "The department that issues building permits here."
              },
              "neighborhoods": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "service_pages": {
                "type": "array",
                "description": "Local pages for the services offered in this city.",
                "items": {
                  "type": "object",
                  "properties": {
                    "service_id": {
                      "type": "string"
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    }
                  },
                  "required": [
                    "service_id",
                    "url"
                  ]
                }
              },
              "verified_at": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date",
                "description": "When the local facts were last checked."
              }
            },
            "required": [
              "served",
              "permit_authority",
              "neighborhoods",
              "service_pages"
            ]
          }
        ]
      },
      "SearchResult": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "section": {
            "type": "string",
            "enum": [
              "pages",
              "services",
              "services-by-city",
              "service-areas",
              "articles"
            ]
          },
          "summary": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "url",
          "section",
          "summary"
        ]
      }
    }
  }
}
