{
  "openapi": "3.1.0",
  "info": {
    "title": "Chambazo public discovery",
    "version": "1.4.0",
    "description": "Read-only facts about businesses whose owner has published a Chambazo page; unclaimed listings are excluded. A failed read returns 503, never an empty list. Town lists are paginated and filtered after paging, so a 200 page with no items means no results on this page: follow nextCursor until it is absent. Per endpoint and instance: 60 requests/minute per caller and 600 total/minute; limits are not global quotas. Menus remain bounded to 200 items and five seconds. Hours text is never parsed into Open now. No account, posting, hiring, ordering or payment action is exposed, and no agent can act for anyone through this API. Additive public discovery: jobs are bounded samples from the existing eligible public Gig projection, with observation time and canonical links. Missing or failed projections return explicit unavailable states (503). Pay aggregates remain unavailable by policy (503). Posted-pay discovery at /pay/postings is a bounded subset of the same public job offers, not realized earnings or market/cohort statistics. No private profiles, drafts, account mutations, registration, callbacks or payment authority."
  },
  "servers": [
    {
      "url": "https://chambazo.com"
    }
  ],
  "paths": {
    "/api/public/v1/businesses/{businessId}": {
      "get": {
        "operationId": "getPublishedBusiness",
        "parameters": [
          {
            "name": "businessId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": true,
            "schema": {
              "enum": [
                "restaurant",
                "services",
                "shops"
              ]
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "enum": [
                "en",
                "es"
              ],
              "default": "en"
            }
          }
        ],
        "description": "Only these parameters are accepted, once each. Identity lookup; use the separate town-list and specials endpoints for discovery. HEAD has the same status and headers with no body; OPTIONS permits GET, HEAD, OPTIONS. CORS is public without credentials.",
        "responses": {
          "200": {
            "description": "Current owner-published snapshot. No independent verification or transaction authority. Menus may be explicitly partial.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Business"
                }
              }
            },
            "headers": {
              "Link": {
                "description": "Canonical citation for these facts. Town lists cite the first page for the same town and business type.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Chambazo-Source": {
                "description": "Publisher to credit when citing this response.",
                "schema": {
                  "const": "Chambazo"
                }
              }
            }
          },
          "400": {
            "description": "invalid_request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "const": "invalid_request"
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "not_found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "const": "not_found"
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "const": "rate_limited"
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds before retry (60)."
              }
            }
          },
          "503": {
            "description": "unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "const": "unavailable"
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/businesses": {
      "get": {
        "operationId": "listPublishedBusinesses",
        "parameters": [
          {
            "name": "area",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 80
            }
          },
          {
            "name": "type",
            "in": "query",
            "schema": {
              "enum": [
                "restaurant",
                "shops",
                "services"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 20
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2000
            }
          }
        ],
        "description": "Existing published-area key matching: case/punctuation normalized, capped at 80 characters, then trailing separators removed. Long owner areas sharing that key can match. Fort Myers differs from Fort Myers, FL. This is not radius, prefix, category or recommendation search. Preserve the opaque cursor with the same area/type and URL-encode its query value. Successful pages cache for 30 seconds; refusals never cache. Test/QA names are omitted. Parameters accepted once each; unknown keys are invalid_request. HEAD and OPTIONS supported; public CORS without credentials.",
        "responses": {
          "200": {
            "description": "Current public discovery snapshot.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublishedBusinessList"
                }
              }
            },
            "headers": {
              "Link": {
                "description": "Canonical citation for these facts. Town lists cite the first page for the same town and business type.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Chambazo-Source": {
                "description": "Publisher to credit when citing this response.",
                "schema": {
                  "const": "Chambazo"
                }
              }
            }
          },
          "400": {
            "description": "invalid_request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "const": "invalid_request"
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "const": "rate_limited"
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds before retry (60)."
              }
            }
          },
          "503": {
            "description": "unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "const": "unavailable"
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/businesses/{businessId}/specials": {
      "get": {
        "operationId": "getLiveBusinessSpecials",
        "parameters": [
          {
            "name": "businessId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "description": "No query parameters. Bilingual public offer text, ending soonest first, at most 20. observedAt is the server clock. Unknown, nonrestaurant, unadmitted or no live specials return the same empty list. Snapshot only: a special may end, pause or sell out immediately. No claim, redemption or payment authority. Parameters accepted once each; unknown keys are invalid_request. HEAD and OPTIONS supported; public CORS without credentials.",
        "responses": {
          "200": {
            "description": "Current public discovery snapshot.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LiveSpecials"
                }
              }
            },
            "headers": {
              "Link": {
                "description": "Canonical citation for these facts. Town lists cite the first page for the same town and business type.",
                "schema": {
                  "type": "string"
                }
              },
              "X-Chambazo-Source": {
                "description": "Publisher to credit when citing this response.",
                "schema": {
                  "const": "Chambazo"
                }
              }
            }
          },
          "400": {
            "description": "invalid_request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "const": "invalid_request"
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "const": "rate_limited"
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds before retry (60)."
              }
            }
          },
          "503": {
            "description": "unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "const": "unavailable"
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/jobs": {
      "get": {
        "operationId": "getPublicJobsDiscovery",
        "summary": "Read public jobs discovery status",
        "description": "Read a bounded eligible public Gig sample. Structured coordinates, address/contact fields, owner identifiers, photos and private descriptions are excluded. No authored text is served: no Gig title, description or poster name; category only as a fixed Chambazo skill value, else null. Installation and availability of the existing public RPC are required. Only locality and limit are accepted. Limits: 60 requests/minute per caller and 600 total/minute for this endpoint and process instance. Refresh before acting; discovery conveys no transaction authority. The v1 fixed-pay schema cannot represent hourly pay ranges. If any eligible hourly Gig in this sample has a range, the whole response is 503 unavailable with reason pay_range_unsupported; if range status cannot be established, it is pay_range_unavailable. A range ceiling is never presented as fixed pay, and affected jobs are not silently filtered out. This temporary v1 limitation can make an entire mixed sample unavailable. Empty and confirmed fixed/flat-pay samples retain the existing shape.",
        "security": [],
        "parameters": [
          {
            "name": "locality",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "string",
              "pattern": "^us-[a-z]{2}-[a-z0-9-]+$",
              "maxLength": 80
            },
            "description": "Optional registered locality ID. Unknown, duplicate or empty query parameters are rejected; this is not radius search."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 24,
              "default": 12
            },
            "description": "Canonical decimal integer 1–24, without signs or leading zeros. A bounded sample, not a total or cursor page."
          }
        ],
        "responses": {
          "400": {
            "description": "Invalid query. No database query is performed.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicJobsInvalidRequest"
                }
              }
            }
          },
          "429": {
            "description": "Per-endpoint, per-instance rate limit reached. These limits are not global quotas.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "Retry-After": {
                "schema": {
                  "const": "60"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicJobsRateLimited"
                }
              }
            }
          },
          "503": {
            "description": "Unavailable is distinct from an observed empty collection. No fallback inventory or aggregate is fabricated.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicJobsUnavailable"
                }
              }
            }
          },
          "200": {
            "description": "Bounded eligible public Gig snapshot. An empty items array is an observed empty result within the query, never a global count.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicJobsSnapshot"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headPublicJobsDiscovery",
        "security": [],
        "parameters": [
          {
            "name": "locality",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "string",
              "pattern": "^us-[a-z]{2}-[a-z0-9-]+$",
              "maxLength": 80
            },
            "description": "Optional registered locality ID. Unknown, duplicate or empty query parameters are rejected; this is not radius search."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 24,
              "default": 12
            },
            "description": "Canonical decimal integer 1–24, without signs or leading zeros. A bounded sample, not a total or cursor page."
          }
        ],
        "responses": {
          "400": {
            "description": "Invalid query. No database query is performed. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          },
          "429": {
            "description": "Per-endpoint, per-instance rate limit reached. These limits are not global quotas. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "Retry-After": {
                "schema": {
                  "const": "60"
                }
              }
            }
          },
          "503": {
            "description": "Unavailable is distinct from an observed empty collection. No fallback inventory or aggregate is fabricated. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          },
          "200": {
            "description": "Bounded eligible public Gig snapshot. An empty items array is an observed empty result within the query, never a global count. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsPublicJobsDiscovery",
        "security": [],
        "responses": {
          "204": {
            "description": "Read-only cross-origin capabilities; no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/pay": {
      "get": {
        "operationId": "getPublicPayDiscovery",
        "summary": "Read public pay discovery status",
        "description": "This endpoint deliberately returns 503 until an approved source, cohort/privacy policy and reproducible aggregate are available. Modelled planning ranges are not measured wages. Only locality and limit are accepted. Limits: 60 requests/minute per caller and 600 total/minute for this endpoint and process instance. Refresh before acting; discovery conveys no transaction authority.",
        "security": [],
        "parameters": [
          {
            "name": "locality",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "string",
              "pattern": "^us-[a-z]{2}-[a-z0-9-]+$",
              "maxLength": 80
            },
            "description": "Optional registered locality ID. Unknown, duplicate or empty query parameters are rejected; this is not radius search."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 24,
              "default": 12
            },
            "description": "Canonical decimal integer 1–24, without signs or leading zeros. A bounded sample, not a total or cursor page."
          }
        ],
        "responses": {
          "400": {
            "description": "Invalid query. No database query is performed.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPayInvalidRequest"
                }
              }
            }
          },
          "429": {
            "description": "Per-endpoint, per-instance rate limit reached. These limits are not global quotas.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "Retry-After": {
                "schema": {
                  "const": "60"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPayRateLimited"
                }
              }
            }
          },
          "503": {
            "description": "Unavailable is distinct from an observed empty collection. No fallback inventory or aggregate is fabricated.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPayUnavailable"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headPublicPayDiscovery",
        "security": [],
        "parameters": [
          {
            "name": "locality",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "string",
              "pattern": "^us-[a-z]{2}-[a-z0-9-]+$",
              "maxLength": 80
            },
            "description": "Optional registered locality ID. Unknown, duplicate or empty query parameters are rejected; this is not radius search."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 24,
              "default": 12
            },
            "description": "Canonical decimal integer 1–24, without signs or leading zeros. A bounded sample, not a total or cursor page."
          }
        ],
        "responses": {
          "400": {
            "description": "Invalid query. No database query is performed. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          },
          "429": {
            "description": "Per-endpoint, per-instance rate limit reached. These limits are not global quotas. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "Retry-After": {
                "schema": {
                  "const": "60"
                }
              }
            }
          },
          "503": {
            "description": "Unavailable is distinct from an observed empty collection. No fallback inventory or aggregate is fabricated. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsPublicPayDiscovery",
        "security": [],
        "responses": {
          "204": {
            "description": "Read-only cross-origin capabilities; no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/pay/postings": {
      "get": {
        "operationId": "getPublicPostedPay",
        "summary": "Read posted pay from public job offers",
        "description": "Uses the exact anonymous eligible nonseed public Gig projection and the same locality/limit grammar, expiry and failure semantics as /jobs. Returns only publicly posted offer pay and canonical Gig links; no title, employer, location, realized worker earnings, averages, cohorts, rates by skill, percentile or market benchmark. basis=posted_job_offers; aggregate=false; realizedEarnings=false; marketBenchmark=false. A bounded sample, not a total/exhaustive search. /pay aggregate endpoint remains503 aggregate_policy_not_approved. Observation time is not a record-updated timestamp. No transaction, payment, pricing or matching authority. Per endpoint/process instance60 requests/minute/caller and600 total/minute, not global quotas. GET/HEAD no-store; HEAD/OPTIONS supported. The v1 fixed-pay schema cannot represent hourly pay ranges. If any eligible hourly Gig in this sample has a range, the whole response is 503 unavailable with reason pay_range_unsupported; if range status cannot be established, it is pay_range_unavailable. A range ceiling is never presented as fixed pay, and affected jobs are not silently filtered out. This temporary v1 limitation can make an entire mixed sample unavailable. Empty and confirmed fixed/flat-pay samples retain the existing shape.",
        "security": [],
        "parameters": [
          {
            "name": "locality",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "string",
              "pattern": "^us-[a-z]{2}-[a-z0-9-]+$",
              "maxLength": 80
            },
            "description": "Optional registered locality ID. Unknown, duplicate or empty query parameters are rejected; this is not radius search."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 24,
              "default": 12
            },
            "description": "Canonical decimal integer 1–24, without signs or leading zeros. A bounded sample, not a total or cursor page."
          }
        ],
        "responses": {
          "400": {
            "description": "Invalid query. No database query is performed.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v1/pay/postings."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPostedPayInvalidRequest"
                }
              }
            }
          },
          "429": {
            "description": "Per-endpoint, per-instance rate limit reached. These limits are not global quotas.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "Retry-After": {
                "schema": {
                  "const": "60"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v1/pay/postings."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPostedPayRateLimited"
                }
              }
            }
          },
          "503": {
            "description": "Unavailable is distinct from an observed empty collection. No fallback inventory or aggregate is fabricated.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v1/pay/postings."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPostedPayUnavailable"
                }
              }
            }
          },
          "200": {
            "description": "Bounded eligible public Gig snapshot. An empty items array is an observed empty result within the query, never a global count.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v1/pay/postings."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPostedPaySnapshot"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headPublicPostedPay",
        "security": [],
        "parameters": [
          {
            "name": "locality",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "string",
              "pattern": "^us-[a-z]{2}-[a-z0-9-]+$",
              "maxLength": 80
            },
            "description": "Optional registered locality ID. Unknown, duplicate or empty query parameters are rejected; this is not radius search."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 24,
              "default": 12
            },
            "description": "Canonical decimal integer 1–24, without signs or leading zeros. A bounded sample, not a total or cursor page."
          }
        ],
        "responses": {
          "400": {
            "description": "Invalid query. No database query is performed. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v1/pay/postings."
              }
            }
          },
          "429": {
            "description": "Per-endpoint, per-instance rate limit reached. These limits are not global quotas. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "Retry-After": {
                "schema": {
                  "const": "60"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v1/pay/postings."
              }
            }
          },
          "503": {
            "description": "Unavailable is distinct from an observed empty collection. No fallback inventory or aggregate is fabricated. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v1/pay/postings."
              }
            }
          },
          "200": {
            "description": "Bounded eligible public Gig snapshot. An empty items array is an observed empty result within the query, never a global count. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v1/pay/postings."
              }
            }
          }
        }
      },
      "options": {
        "operationId": "optionsPublicPostedPay",
        "security": [],
        "responses": {
          "204": {
            "description": "Read-only cross-origin capabilities; no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v2/jobs": {
      "get": {
        "operationId": "getPublicJobsDiscoveryV2",
        "summary": "Read public Gig discovery with explicit pay states",
        "description": "Read the same bounded anonymous public Gig projection as v1 with explicit per-item fixed/range/unknown posted pay. Only locality and limit are accepted; at most 24 items, default 12, with one 8-second total read deadline. A valid minimum and the public ceiling retain hourly minRateCents/maxRateCents and add derivedMidpoint: a DERIVED arithmetic midpoint in integer USD cents per hour, rounded to the nearest cent with exact half cents up. It is a planning reference, not offered or guaranteed pay; never replace the original bounds or compute a range shift total. Fixed hourly pay is confirmed by a literal disabled range switch or, with ranges enabled, by one anonymous read that returns the Gig's own row, hourly at exactly the listed rate, with no range row beside it. A listed Gig that read cannot see, or whose rate or pay type differs from the list, is unknown on its own; denied/malformed evidence or a range-read timeout leaves every hourly item unknown. Unknown has no numeric amount, and independently valid flat, fixed and range items remain available. Failed or malformed base Gig projection remains 503. No authored free text, coordinates, private fields or extra database privileges. Observation is not an atomic quotation, agreed hire rate, inventory total, aggregate or earnings benchmark. Refresh in the app before acting. v1 remains unchanged.",
        "security": [],
        "parameters": [
          {
            "name": "locality",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "string",
              "pattern": "^us-[a-z]{2}-[a-z0-9-]+$",
              "maxLength": 80
            },
            "description": "Optional registered locality ID. Unknown, duplicate or empty query parameters are rejected; this is not radius search."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 24,
              "default": 12
            },
            "description": "Canonical decimal integer 1–24, without signs or leading zeros. A bounded sample, not a total or cursor page."
          }
        ],
        "responses": {
          "400": {
            "description": "Invalid query. No database query is performed.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicJobsInvalidRequestV2"
                }
              }
            }
          },
          "429": {
            "description": "Per-endpoint, per-instance rate limit reached. These limits are not global quotas.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "Retry-After": {
                "schema": {
                  "const": "60"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicJobsRateLimitedV2"
                }
              }
            }
          },
          "503": {
            "description": "Base public Gig projection unavailable, failed or malformed. Range-only evidence loss is represented by unknown pay in an otherwise valid 200 sample.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicJobsUnavailableV2"
                }
              }
            }
          },
          "200": {
            "description": "Bounded public sample with per-item pay evidence; unknown pay never carries an amount.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicJobsSnapshotV2"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headPublicJobsDiscoveryV2",
        "security": [],
        "parameters": [
          {
            "name": "locality",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "string",
              "pattern": "^us-[a-z]{2}-[a-z0-9-]+$",
              "maxLength": 80
            },
            "description": "Optional registered locality ID. Unknown, duplicate or empty query parameters are rejected; this is not radius search."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 24,
              "default": 12
            },
            "description": "Canonical decimal integer 1–24, without signs or leading zeros. A bounded sample, not a total or cursor page."
          }
        ],
        "responses": {
          "400": {
            "description": "Invalid query. No database query is performed. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          },
          "429": {
            "description": "Per-endpoint, per-instance rate limit reached. These limits are not global quotas. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "Retry-After": {
                "schema": {
                  "const": "60"
                }
              }
            }
          },
          "503": {
            "description": "Base public Gig projection unavailable, failed or malformed. Range-only evidence loss is represented by unknown pay in an otherwise valid 200 sample.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          },
          "200": {
            "description": "Bounded public sample with per-item pay evidence; unknown pay never carries an amount.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          }
        },
        "description": "Same status and headers as GET, with no response body; the same bounded read and rate gate apply."
      },
      "options": {
        "operationId": "optionsPublicJobsDiscoveryV2",
        "security": [],
        "responses": {
          "204": {
            "description": "Read-only cross-origin capabilities; no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v2/pay/postings": {
      "get": {
        "operationId": "getPublicPostedPayV2",
        "summary": "Read public posted Gig pay with explicit pay states",
        "description": "Read the same bounded anonymous public Gig projection as v1 with explicit per-item fixed/range/unknown posted pay. Only locality and limit are accepted; at most 24 items, default 12, with one 8-second total read deadline. A valid minimum and the public ceiling retain hourly minRateCents/maxRateCents and add derivedMidpoint: a DERIVED arithmetic midpoint in integer USD cents per hour, rounded to the nearest cent with exact half cents up. It is a planning reference, not offered or guaranteed pay; never replace the original bounds or compute a range shift total. Fixed hourly pay is confirmed by a literal disabled range switch or, with ranges enabled, by one anonymous read that returns the Gig's own row, hourly at exactly the listed rate, with no range row beside it. A listed Gig that read cannot see, or whose rate or pay type differs from the list, is unknown on its own; denied/malformed evidence or a range-read timeout leaves every hourly item unknown. Unknown has no numeric amount, and independently valid flat, fixed and range items remain available. Failed or malformed base Gig projection remains 503. No authored free text, coordinates, private fields or extra database privileges. Observation is not an atomic quotation, agreed hire rate, inventory total, aggregate or earnings benchmark. Refresh in the app before acting. v1 remains unchanged.",
        "security": [],
        "parameters": [
          {
            "name": "locality",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "string",
              "pattern": "^us-[a-z]{2}-[a-z0-9-]+$",
              "maxLength": 80
            },
            "description": "Optional registered locality ID. Unknown, duplicate or empty query parameters are rejected; this is not radius search."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 24,
              "default": 12
            },
            "description": "Canonical decimal integer 1–24, without signs or leading zeros. A bounded sample, not a total or cursor page."
          }
        ],
        "responses": {
          "400": {
            "description": "Invalid query. No database query is performed.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v2/pay/postings."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPostedPayInvalidRequestV2"
                }
              }
            }
          },
          "429": {
            "description": "Per-endpoint, per-instance rate limit reached. These limits are not global quotas.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "Retry-After": {
                "schema": {
                  "const": "60"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v2/pay/postings."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPostedPayRateLimitedV2"
                }
              }
            }
          },
          "503": {
            "description": "Base public Gig projection unavailable, failed or malformed. Range-only evidence loss is represented by unknown pay in an otherwise valid 200 sample.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v2/pay/postings."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPostedPayUnavailableV2"
                }
              }
            }
          },
          "200": {
            "description": "Bounded public sample with per-item pay evidence; unknown pay never carries an amount.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v2/pay/postings."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicPostedPaySnapshotV2"
                }
              }
            }
          }
        }
      },
      "head": {
        "operationId": "headPublicPostedPayV2",
        "security": [],
        "parameters": [
          {
            "name": "locality",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "string",
              "pattern": "^us-[a-z]{2}-[a-z0-9-]+$",
              "maxLength": 80
            },
            "description": "Optional registered locality ID. Unknown, duplicate or empty query parameters are rejected; this is not radius search."
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "allowEmptyValue": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 24,
              "default": 12
            },
            "description": "Canonical decimal integer 1–24, without signs or leading zeros. A bounded sample, not a total or cursor page."
          }
        ],
        "responses": {
          "400": {
            "description": "Invalid query. No database query is performed. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v2/pay/postings."
              }
            }
          },
          "429": {
            "description": "Per-endpoint, per-instance rate limit reached. These limits are not global quotas. HEAD returns no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "Retry-After": {
                "schema": {
                  "const": "60"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v2/pay/postings."
              }
            }
          },
          "503": {
            "description": "Base public Gig projection unavailable, failed or malformed. Range-only evidence loss is represented by unknown pay in an otherwise valid 200 sample.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v2/pay/postings."
              }
            }
          },
          "200": {
            "description": "Bounded public sample with per-item pay evidence; unknown pay never carries an amount.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              },
              "X-Chambazo-Source": {
                "schema": {
                  "const": "Chambazo"
                }
              },
              "Access-Control-Expose-Headers": {
                "schema": {
                  "const": "Link, X-Chambazo-Source"
                }
              },
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Canonical first-page collection URL with the same valid locality, on https://chambazo.com/api/public/v2/pay/postings."
              }
            }
          }
        },
        "description": "Same status and headers as GET, with no response body; the same bounded read and rate gate apply."
      },
      "options": {
        "operationId": "optionsPublicPostedPayV2",
        "security": [],
        "responses": {
          "204": {
            "description": "Read-only cross-origin capabilities; no body.",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "Access-Control-Allow-Methods": {
                "schema": {
                  "const": "GET, HEAD, OPTIONS"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            }
          }
        }
      }
    },
    "/data/gig-pay.json": {
      "get": {
        "operationId": "getGigPostedPay",
        "summary": "Read posted-pay figures for Chambazo Gigs",
        "description": "One static JSON document, regenerated about hourly from a six-hour snapshot; it takes no parameters and no request reaches the database. A figure is the middle half of the hourly pay posted on real, listed Gigs in one area for one kind of work, published only when at least 5 hourly Gigs from at least 3 different hirers back it in the last 90 days and no single hirer posted more than half of them; otherwise the area widens from town to county to South Florida to Florida. It is posted pay, not realized earnings and not a market benchmark. When state is not_enough_gigs the list is empty by design. The separate /api/public/v1/pay endpoint is unchanged and still answers 503.",
        "security": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "The document. Read figures only when state is measured.",
            "headers": {
              "Access-Control-Allow-Origin": {
                "schema": {
                  "const": "*"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "const": "nosniff"
                }
              },
              "X-Robots-Tag": {
                "schema": {
                  "const": "noindex"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicGigPostedPay"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Business": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "schemaVersion",
          "id",
          "type",
          "canonicalUrl",
          "claimStatus",
          "evidenceStatus",
          "observedAt",
          "profileVersion",
          "name",
          "area",
          "description",
          "address",
          "location",
          "hoursText",
          "phone",
          "website",
          "menu"
        ],
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "enum": [
              "restaurant",
              "services",
              "shops"
            ]
          },
          "canonicalUrl": {
            "type": "string",
            "format": "uri"
          },
          "claimStatus": {
            "const": "owner-published"
          },
          "evidenceStatus": {
            "const": "owner-supplied-not-independently-verified"
          },
          "observedAt": {
            "type": "string",
            "format": "date-time"
          },
          "name": {
            "type": "string"
          },
          "area": {
            "type": "string"
          },
          "description": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "en",
              "es"
            ],
            "properties": {
              "en": {
                "type": "string"
              },
              "es": {
                "type": "string"
              }
            }
          },
          "address": {
            "type": [
              "string",
              "null"
            ]
          },
          "location": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "required": [
                  "latitude",
                  "longitude"
                ],
                "additionalProperties": false,
                "properties": {
                  "latitude": {
                    "type": "number"
                  },
                  "longitude": {
                    "type": "number"
                  }
                }
              }
            ]
          },
          "hoursText": {
            "type": [
              "string",
              "null"
            ]
          },
          "phone": {
            "type": [
              "string",
              "null"
            ]
          },
          "website": {
            "type": [
              "string",
              "null"
            ]
          },
          "menu": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "state",
                  "complete",
                  "items"
                ],
                "properties": {
                  "state": {
                    "enum": [
                      "ready",
                      "unavailable"
                    ]
                  },
                  "complete": {
                    "type": "boolean"
                  },
                  "items": {
                    "type": "array",
                    "maxItems": 200,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "required": [
                        "id",
                        "section",
                        "name",
                        "description",
                        "priceMinor",
                        "currency",
                        "available"
                      ],
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "section": {
                          "type": "string"
                        },
                        "name": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "en",
                            "es"
                          ],
                          "properties": {
                            "en": {
                              "type": "string"
                            },
                            "es": {
                              "type": "string"
                            }
                          }
                        },
                        "description": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "en",
                            "es"
                          ],
                          "properties": {
                            "en": {
                              "type": "string"
                            },
                            "es": {
                              "type": "string"
                            }
                          }
                        },
                        "priceMinor": {
                          "type": "integer",
                          "minimum": 0
                        },
                        "currency": {
                          "const": "USD"
                        },
                        "available": {
                          "type": "boolean"
                        }
                      }
                    }
                  }
                }
              }
            ]
          },
          "profileVersion": {
            "type": "integer"
          }
        }
      },
      "PublishedBusinessSummary": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "type",
          "name",
          "area",
          "publicationVersion",
          "publishedAt",
          "canonicalUrl",
          "claimStatus",
          "evidenceStatus"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "enum": [
              "restaurant",
              "shops",
              "services"
            ]
          },
          "name": {
            "type": "string"
          },
          "area": {
            "type": "string"
          },
          "publicationVersion": {
            "type": "integer",
            "minimum": 1
          },
          "publishedAt": {
            "type": "string",
            "format": "date-time"
          },
          "canonicalUrl": {
            "type": "string",
            "format": "uri"
          },
          "claimStatus": {
            "const": "owner-published"
          },
          "evidenceStatus": {
            "const": "owner-supplied-not-independently-verified"
          }
        }
      },
      "PublishedBusinessList": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "schemaVersion",
          "observedAt",
          "nextCursor",
          "areaMatch",
          "items"
        ],
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "observedAt": {
            "type": "string",
            "format": "date-time"
          },
          "nextCursor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2000
          },
          "areaMatch": {
            "const": "normalized-published-area-key"
          },
          "items": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/PublishedBusinessSummary"
            }
          }
        }
      },
      "LiveSpecial": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "title",
          "terms",
          "priceMinor",
          "originalPriceMinor",
          "currency",
          "status",
          "availability",
          "startsAt",
          "endsAt",
          "timeZone",
          "canonicalUrl"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "title": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "en",
              "es"
            ],
            "properties": {
              "en": {
                "type": "string"
              },
              "es": {
                "type": "string"
              }
            }
          },
          "terms": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "en",
              "es"
            ],
            "properties": {
              "en": {
                "type": "string"
              },
              "es": {
                "type": "string"
              }
            }
          },
          "priceMinor": {
            "type": "integer",
            "minimum": 0
          },
          "originalPriceMinor": {
            "type": "integer",
            "minimum": 0
          },
          "currency": {
            "const": "USD"
          },
          "status": {
            "const": "live"
          },
          "availability": {
            "const": "available"
          },
          "startsAt": {
            "type": "string",
            "format": "date-time"
          },
          "endsAt": {
            "type": "string",
            "format": "date-time"
          },
          "timeZone": {
            "type": "string"
          },
          "canonicalUrl": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "LiveSpecials": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "schemaVersion",
          "businessId",
          "observedAt",
          "items"
        ],
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "businessId": {
            "type": "string",
            "format": "uuid"
          },
          "observedAt": {
            "type": "string",
            "format": "date-time"
          },
          "items": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "$ref": "#/components/schemas/LiveSpecial"
            }
          }
        }
      },
      "PublicAgentJob": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "Bartending",
              "Cooking",
              "Serving",
              "Event Staff",
              "Warehouse",
              "Delivery",
              "Customer Service",
              "Retail",
              "Cleaning",
              "General Labor",
              "Tech",
              "Admin",
              "Driving",
              "Landscaping",
              "Moving",
              "Photography",
              "Catering",
              "Hosting",
              "Cashier",
              "Party Staff",
              "Handyman",
              "Pet Care",
              "Valet",
              "Beauty & Grooming",
              "Music & DJ",
              "Entertainment",
              "Security",
              "Boat & Marine",
              "Production & AV",
              "Other",
              null
            ],
            "description": "One of Chambazo's fixed Gig skill values, or null. Never text a person typed."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "pattern": "^https://chambazo\\.com/g/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
          },
          "area": {
            "anyOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "localityId": {
                    "type": "string",
                    "pattern": "^us-[a-z]{2}-[a-z0-9-]+$",
                    "maxLength": 80
                  }
                },
                "required": [
                  "label",
                  "localityId"
                ],
                "additionalProperties": false
              }
            ],
            "description": "Locality-registry label and id of the Gig's validated locality, or null. Never typed location text."
          },
          "pay": {
            "type": "object",
            "properties": {
              "currency": {
                "const": "USD"
              },
              "type": {
                "enum": [
                  "hourly",
                  "flat"
                ]
              },
              "rateCents": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991
              },
              "shiftCents": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "currency",
              "type",
              "rateCents",
              "shiftCents"
            ],
            "additionalProperties": false
          },
          "shift": {
            "type": "object",
            "properties": {
              "startsAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
              },
              "endsAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
              },
              "fillableUntil": {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
              }
            },
            "required": [
              "startsAt",
              "endsAt",
              "fillableUntil"
            ],
            "additionalProperties": false
          },
          "spotsLeft": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "id",
          "category",
          "url",
          "area",
          "pay",
          "shift",
          "spotsLeft"
        ],
        "additionalProperties": false
      },
      "PublicJobsSnapshot": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "state": {
            "const": "ready"
          },
          "kind": {
            "const": "jobs"
          },
          "source": {
            "type": "object",
            "properties": {
              "name": {
                "const": "Chambazo"
              },
              "url": {
                "const": "https://chambazo.com"
              },
              "retrievedAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
                "description": "Observation time, not a record modification timestamp or guarantee of continued availability."
              }
            },
            "required": [
              "name",
              "url",
              "retrievedAt"
            ],
            "additionalProperties": false
          },
          "items": {
            "type": "array",
            "maxItems": 24,
            "items": {
              "$ref": "#/components/schemas/PublicAgentJob"
            }
          },
          "page": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 24
              },
              "returned": {
                "type": "integer",
                "minimum": 0,
                "maximum": 24
              }
            },
            "required": [
              "limit",
              "returned"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind",
          "source",
          "items",
          "page"
        ],
        "additionalProperties": false
      },
      "PublicJobsUnavailable": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "state": {
            "const": "unavailable"
          },
          "kind": {
            "const": "jobs"
          },
          "reason": {
            "enum": [
              "projection_not_installed",
              "permission_denied",
              "invalid_area",
              "timeout",
              "read_failed",
              "invalid_projection",
              "pay_range_unsupported",
              "pay_range_unavailable"
            ]
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind",
          "reason"
        ],
        "additionalProperties": false
      },
      "PublicJobsInvalidRequest": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "state": {
            "const": "invalid_request"
          },
          "kind": {
            "const": "jobs"
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind"
        ],
        "additionalProperties": false
      },
      "PublicJobsRateLimited": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "state": {
            "const": "rate_limited"
          },
          "kind": {
            "const": "jobs"
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind"
        ],
        "additionalProperties": false
      },
      "PublicPayUnavailable": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "state": {
            "const": "unavailable"
          },
          "kind": {
            "const": "pay"
          },
          "reason": {
            "enum": [
              "aggregate_policy_not_approved"
            ]
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind",
          "reason"
        ],
        "additionalProperties": false
      },
      "PublicPayInvalidRequest": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "state": {
            "const": "invalid_request"
          },
          "kind": {
            "const": "pay"
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind"
        ],
        "additionalProperties": false
      },
      "PublicPayRateLimited": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "state": {
            "const": "rate_limited"
          },
          "kind": {
            "const": "pay"
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind"
        ],
        "additionalProperties": false
      },
      "PublicPostedPayInvalidRequest": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "state": {
            "const": "invalid_request"
          },
          "kind": {
            "const": "pay-postings"
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind"
        ],
        "additionalProperties": false
      },
      "PublicPostedPayRateLimited": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "state": {
            "const": "rate_limited"
          },
          "kind": {
            "const": "pay-postings"
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind"
        ],
        "additionalProperties": false
      },
      "PublicPostedPayUnavailable": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "state": {
            "const": "unavailable"
          },
          "kind": {
            "const": "pay-postings"
          },
          "reason": {
            "enum": [
              "projection_not_installed",
              "permission_denied",
              "invalid_area",
              "timeout",
              "read_failed",
              "invalid_projection",
              "pay_range_unsupported",
              "pay_range_unavailable"
            ]
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind",
          "reason"
        ],
        "additionalProperties": false
      },
      "PublicPostedPaySnapshot": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "kind": {
            "const": "pay-postings"
          },
          "state": {
            "const": "ready"
          },
          "basis": {
            "const": "posted_job_offers"
          },
          "aggregate": {
            "const": false
          },
          "realizedEarnings": {
            "const": false
          },
          "marketBenchmark": {
            "const": false
          },
          "source": {
            "type": "object",
            "properties": {
              "name": {
                "const": "Chambazo"
              },
              "url": {
                "const": "https://chambazo.com"
              },
              "retrievedAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
                "description": "Observation time, not a record modification timestamp or guarantee of continued availability."
              }
            },
            "required": [
              "name",
              "url",
              "retrievedAt"
            ],
            "additionalProperties": false
          },
          "items": {
            "type": "array",
            "maxItems": 24,
            "items": {
              "type": "object",
              "properties": {
                "jobId": {
                  "type": "string",
                  "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
                },
                "url": {
                  "type": "string",
                  "pattern": "^https://chambazo\\.com/g/[0-9a-f-]{36}$"
                },
                "currency": {
                  "const": "USD"
                },
                "type": {
                  "enum": [
                    "hourly",
                    "flat"
                  ]
                },
                "rateCents": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 9007199254740991
                },
                "shiftCents": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "jobId",
                "url",
                "currency",
                "type",
                "rateCents",
                "shiftCents"
              ],
              "additionalProperties": false
            }
          },
          "page": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 24
              },
              "returned": {
                "type": "integer",
                "minimum": 0,
                "maximum": 24
              }
            },
            "required": [
              "limit",
              "returned"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "schemaVersion",
          "kind",
          "state",
          "basis",
          "aggregate",
          "realizedEarnings",
          "marketBenchmark",
          "source",
          "items",
          "page"
        ],
        "additionalProperties": false
      },
      "PublicAgentJobV2": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "Bartending",
              "Cooking",
              "Serving",
              "Event Staff",
              "Warehouse",
              "Delivery",
              "Customer Service",
              "Retail",
              "Cleaning",
              "General Labor",
              "Tech",
              "Admin",
              "Driving",
              "Landscaping",
              "Moving",
              "Photography",
              "Catering",
              "Hosting",
              "Cashier",
              "Party Staff",
              "Handyman",
              "Pet Care",
              "Valet",
              "Beauty & Grooming",
              "Music & DJ",
              "Entertainment",
              "Security",
              "Boat & Marine",
              "Production & AV",
              "Other",
              null
            ],
            "description": "One of Chambazo's fixed Gig skill values, or null. Never text a person typed."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "pattern": "^https://chambazo\\.com/g/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
          },
          "area": {
            "anyOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "localityId": {
                    "type": "string",
                    "pattern": "^us-[a-z]{2}-[a-z0-9-]+$",
                    "maxLength": 80
                  }
                },
                "required": [
                  "label",
                  "localityId"
                ],
                "additionalProperties": false
              }
            ],
            "description": "Locality-registry label and id of the Gig's validated locality, or null. Never typed location text."
          },
          "pay": {
            "$ref": "#/components/schemas/PublicPostedPayAmountV2"
          },
          "shift": {
            "type": "object",
            "properties": {
              "startsAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
              },
              "endsAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
              },
              "fillableUntil": {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
              }
            },
            "required": [
              "startsAt",
              "endsAt",
              "fillableUntil"
            ],
            "additionalProperties": false
          },
          "spotsLeft": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "id",
          "category",
          "url",
          "area",
          "pay",
          "shift",
          "spotsLeft"
        ],
        "additionalProperties": false
      },
      "PublicJobsSnapshotV2": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 2
          },
          "state": {
            "const": "ready"
          },
          "kind": {
            "const": "jobs"
          },
          "source": {
            "type": "object",
            "properties": {
              "name": {
                "const": "Chambazo"
              },
              "url": {
                "const": "https://chambazo.com"
              },
              "retrievedAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
                "description": "Observation time, not a record modification timestamp or guarantee of continued availability."
              }
            },
            "required": [
              "name",
              "url",
              "retrievedAt"
            ],
            "additionalProperties": false
          },
          "items": {
            "type": "array",
            "maxItems": 24,
            "items": {
              "$ref": "#/components/schemas/PublicAgentJobV2"
            }
          },
          "page": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 24
              },
              "returned": {
                "type": "integer",
                "minimum": 0,
                "maximum": 24
              }
            },
            "required": [
              "limit",
              "returned"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind",
          "source",
          "items",
          "page"
        ],
        "additionalProperties": false
      },
      "PublicJobsUnavailableV2": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 2
          },
          "state": {
            "const": "unavailable"
          },
          "kind": {
            "const": "jobs"
          },
          "reason": {
            "enum": [
              "projection_not_installed",
              "permission_denied",
              "invalid_area",
              "timeout",
              "read_failed",
              "invalid_projection"
            ]
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind",
          "reason"
        ],
        "additionalProperties": false
      },
      "PublicJobsInvalidRequestV2": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 2
          },
          "state": {
            "const": "invalid_request"
          },
          "kind": {
            "const": "jobs"
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind"
        ],
        "additionalProperties": false
      },
      "PublicJobsRateLimitedV2": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 2
          },
          "state": {
            "const": "rate_limited"
          },
          "kind": {
            "const": "jobs"
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind"
        ],
        "additionalProperties": false
      },
      "PublicPostedPayInvalidRequestV2": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 2
          },
          "state": {
            "const": "invalid_request"
          },
          "kind": {
            "const": "pay-postings"
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind"
        ],
        "additionalProperties": false
      },
      "PublicPostedPayRateLimitedV2": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 2
          },
          "state": {
            "const": "rate_limited"
          },
          "kind": {
            "const": "pay-postings"
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind"
        ],
        "additionalProperties": false
      },
      "PublicPostedPayUnavailableV2": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 2
          },
          "state": {
            "const": "unavailable"
          },
          "kind": {
            "const": "pay-postings"
          },
          "reason": {
            "enum": [
              "projection_not_installed",
              "permission_denied",
              "invalid_area",
              "timeout",
              "read_failed",
              "invalid_projection"
            ]
          }
        },
        "required": [
          "schemaVersion",
          "state",
          "kind",
          "reason"
        ],
        "additionalProperties": false
      },
      "PublicPostedPaySnapshotV2": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "const": 2
          },
          "kind": {
            "const": "pay-postings"
          },
          "state": {
            "const": "ready"
          },
          "basis": {
            "const": "posted_job_offers"
          },
          "aggregate": {
            "const": false
          },
          "realizedEarnings": {
            "const": false
          },
          "marketBenchmark": {
            "const": false
          },
          "source": {
            "type": "object",
            "properties": {
              "name": {
                "const": "Chambazo"
              },
              "url": {
                "const": "https://chambazo.com"
              },
              "retrievedAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
                "description": "Observation time, not a record modification timestamp or guarantee of continued availability."
              }
            },
            "required": [
              "name",
              "url",
              "retrievedAt"
            ],
            "additionalProperties": false
          },
          "items": {
            "type": "array",
            "maxItems": 24,
            "items": {
              "type": "object",
              "properties": {
                "jobId": {
                  "type": "string",
                  "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
                },
                "url": {
                  "type": "string",
                  "pattern": "^https://chambazo\\.com/g/[0-9a-f-]{36}$"
                },
                "pay": {
                  "$ref": "#/components/schemas/PublicPostedPayAmountV2"
                }
              },
              "required": [
                "jobId",
                "url",
                "pay"
              ],
              "additionalProperties": false
            }
          },
          "page": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 24
              },
              "returned": {
                "type": "integer",
                "minimum": 0,
                "maximum": 24
              }
            },
            "required": [
              "limit",
              "returned"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "schemaVersion",
          "kind",
          "state",
          "basis",
          "aggregate",
          "realizedEarnings",
          "marketBenchmark",
          "source",
          "items",
          "page"
        ],
        "additionalProperties": false
      },
      "PublicPostedPayAmountV2": {
        "description": "Posted pay observation, not a transaction quote or agreed hire rate. Unknown contains no numeric amount. Range retains hourly bounds and adds a separately labelled derivedMidpoint planning reference, never offered or guaranteed pay. No top-level scalar rate or computed range shift total. With ranges enabled, fixed hourly requires the Gig's own row with no range row in the same anonymous read; a minimum missing because the Gig itself was not readable is unknown, never fixed.",
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "state": {
                "const": "fixed"
              },
              "type": {
                "const": "hourly"
              },
              "currency": {
                "const": "USD"
              },
              "rateCents": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991
              },
              "shiftCents": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "state",
              "type",
              "currency",
              "rateCents",
              "shiftCents"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "state": {
                "const": "fixed"
              },
              "type": {
                "const": "flat"
              },
              "currency": {
                "const": "USD"
              },
              "shiftCents": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "state",
              "type",
              "currency",
              "shiftCents"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "state": {
                "const": "range"
              },
              "type": {
                "const": "hourly"
              },
              "currency": {
                "const": "USD"
              },
              "minRateCents": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991
              },
              "maxRateCents": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991
              },
              "derivedMidpoint": {
                "type": "object",
                "description": "DERIVED arithmetic midpoint of the original hourly bounds. Integer USD cents per hour: (minRateCents + maxRateCents) / 2 rounded to the nearest cent, with an exact half cent rounded up. Computed with exact integer arithmetic. A planning reference, not offered or guaranteed pay; display with the unchanged original range.",
                "properties": {
                  "label": {
                    "const": "DERIVED"
                  },
                  "rateCents": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991
                  },
                  "currency": {
                    "const": "USD"
                  },
                  "unit": {
                    "const": "hour"
                  },
                  "method": {
                    "const": "arithmetic_midpoint"
                  },
                  "rounding": {
                    "const": "nearest_cent_half_up"
                  },
                  "isOfferedPay": {
                    "const": false
                  },
                  "isGuaranteedPay": {
                    "const": false
                  }
                },
                "required": [
                  "label",
                  "rateCents",
                  "currency",
                  "unit",
                  "method",
                  "rounding",
                  "isOfferedPay",
                  "isGuaranteedPay"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "state",
              "type",
              "currency",
              "minRateCents",
              "maxRateCents",
              "derivedMidpoint"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "state": {
                "const": "unknown"
              },
              "type": {
                "const": "hourly"
              },
              "currency": {
                "const": "USD"
              },
              "reason": {
                "const": "range_evidence_unavailable"
              }
            },
            "required": [
              "state",
              "type",
              "currency",
              "reason"
            ],
            "additionalProperties": false
          }
        ]
      },
      "PublicGigPostedPay": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "schemaVersion",
          "kind",
          "state",
          "source",
          "policy",
          "asOf",
          "window",
          "figures",
          "suggestedWhenPosting"
        ],
        "properties": {
          "schemaVersion": {
            "const": 1
          },
          "kind": {
            "const": "gig-posted-pay"
          },
          "state": {
            "enum": [
              "measured",
              "not_enough_gigs",
              "unavailable"
            ],
            "description": "measured: at least one figure. not_enough_gigs: the read worked and no area reaches the minimum sample, so figures is empty and no other number may be substituted. unavailable: the read failed; figures is empty and means nothing."
          },
          "source": {
            "type": "object"
          },
          "policy": {
            "type": "object",
            "description": "The rules every figure obeys: basis posted_hourly_gig_offers, the middle half (25th to 75th percentile), the window in days, the minimum Gigs and hirers, the largest share one hirer may hold, and the fee rate the hiring side pays on top. realizedEarnings and marketBenchmark are always false."
          },
          "asOf": {
            "type": [
              "string",
              "null"
            ],
            "description": "Day the Gigs were read (America/New_York), YYYY-MM-DD."
          },
          "window": {
            "type": [
              "object",
              "null"
            ]
          },
          "figures": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "kind",
                "kindName",
                "areaLevel",
                "areaKey",
                "areaName",
                "gigs",
                "hirers",
                "postedLowCents",
                "postedHighCents",
                "hiringSideLowCents",
                "hiringSideHighCents",
                "firstPostedDay",
                "lastPostedDay",
                "page"
              ],
              "properties": {
                "kind": {
                  "type": "string",
                  "description": "A Chambazo Gig kind of work key (for example cleaning, moving, bartending), or all for every kind together."
                },
                "kindName": {
                  "type": "object"
                },
                "areaLevel": {
                  "enum": [
                    "town",
                    "county",
                    "region",
                    "state"
                  ]
                },
                "areaKey": {
                  "type": "string"
                },
                "areaName": {
                  "type": "string"
                },
                "gigs": {
                  "type": "integer",
                  "minimum": 5,
                  "description": "Hourly Gigs behind the figure."
                },
                "hirers": {
                  "type": "integer",
                  "minimum": 3,
                  "description": "Different hirers behind the figure."
                },
                "postedLowCents": {
                  "type": "integer",
                  "description": "25th percentile of posted hourly pay, USD cents."
                },
                "postedHighCents": {
                  "type": "integer",
                  "description": "75th percentile of posted hourly pay, USD cents."
                },
                "hiringSideLowCents": {
                  "type": "integer",
                  "description": "postedLowCents plus the fee the hiring side pays on top."
                },
                "hiringSideHighCents": {
                  "type": "integer",
                  "description": "postedHighCents plus the fee the hiring side pays on top."
                },
                "firstPostedDay": {
                  "type": "string"
                },
                "lastPostedDay": {
                  "type": "string"
                },
                "page": {
                  "type": [
                    "object",
                    "null"
                  ]
                }
              }
            }
          },
          "suggestedWhenPosting": {
            "type": "object",
            "description": "NOT measured: the ranges the posting form suggests, written by Chambazo. Never quote them as posted pay, typical pay or a going rate."
          }
        }
      }
    }
  }
}
