{
 "openapi": "3.1.0",
 "info": {
  "title": "Kolaboro API v1",
  "version": "2026-11-17",
  "summary": "Open, read-only JSON about tracked off-plan projects and their developers.",
  "description": "No key. CORS open. Rate limit 120 calls a minute per IP per endpoint group, announced in RateLimit-Policy and RateLimit (draft-ietf-httpapi-ratelimit-headers) and X-RateLimit-*. ETag on every answer: send If-None-Match to get 304. Ids (BALI-014) and slugs are stable. Playground: https://kolaboro.com/api/docs/. Full description of every public endpoint: https://kolaboro.com/docs/api/openapi.json",
  "license": {
   "name": "CC BY 4.0 (credit: Kolaboro, kolaboro.com)",
   "identifier": "CC-BY-4.0"
  },
  "contact": {
   "name": "Kolaboro",
   "url": "https://kolaboro.com/about"
  }
 },
 "servers": [
  {
   "url": "https://kolaboro.com"
  }
 ],
 "paths": {
  "/api/v1/projects": {
   "get": {
    "tags": [
     "Named projects"
    ],
    "summary": "All named projects",
    "description": "Slug, id, name and API URL of every named project. No key needed.",
    "operationId": "v1_projects",
    "security": [],
    "parameters": [
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "ETag from an earlier response; answered with 304 when unchanged."
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       },
       "Cache-Control": {
        "schema": {
         "type": "string"
        },
        "description": "public, max-age=300 (900 for lists and the search index)"
       },
       "X-RateLimit-Limit": {
        "schema": {
         "type": "string"
        },
        "description": "120;w=60"
       },
       "X-RateLimit-Remaining": {
        "schema": {
         "type": "integer"
        }
       },
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "count": {
           "type": "integer"
          },
          "projects": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "slug": {
              "type": "string"
             },
             "id": {
              "type": "string"
             },
             "name": {
              "type": "string"
             },
             "market": {
              "type": "string"
             },
             "api": {
              "type": "string"
             }
            }
           }
          }
         }
        }
       }
      }
     },
     "304": {
      "description": "Not modified (If-None-Match matched)",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       }
      }
     },
     "429": {
      "description": "Rate limited (120 per minute per IP)",
      "headers": {
       "Retry-After": {
        "schema": {
         "type": "integer"
        }
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "string",
           "example": "rate_limited"
          },
          "retry_after_s": {
           "type": "integer"
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/projects/{slug}": {
   "get": {
    "tags": [
     "Named projects"
    ],
    "summary": "Named facts of one project",
    "description": "Everything the named page /projects/{slug}/ shows, as JSON: developer, location, stage, permit number, handover and other promises with their dated history, changes seen on the developer page, sealed copy, register checks, public reports and sources. Projects not yet reviewed have reviewed=false and review=null (no score). No key needed; CORS open; strong ETag; rate limit 120/min per IP.",
    "operationId": "v1_project",
    "security": [],
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "description": "Project slug as in /projects/{slug}/",
      "schema": {
       "type": "string",
       "pattern": "^[a-z0-9-]{1,90}$"
      },
      "example": "amani-melasti"
     },
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "ETag from an earlier response; answered with 304 when unchanged."
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       },
       "Cache-Control": {
        "schema": {
         "type": "string"
        },
        "description": "public, max-age=300 (900 for lists and the search index)"
       },
       "X-RateLimit-Limit": {
        "schema": {
         "type": "string"
        },
        "description": "120;w=60"
       },
       "X-RateLimit-Remaining": {
        "schema": {
         "type": "integer"
        }
       },
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "api": {
           "type": "string",
           "example": "kolaboro-named-v1"
          },
          "license": {
           "type": "string"
          },
          "rules": {
           "type": "string"
          },
          "id": {
           "type": "string",
           "example": "BALI-001"
          },
          "slug": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "developer": {
           "type": [
            "object",
            "null"
           ],
           "properties": {
            "name": {
             "type": "string"
            },
            "slug": {
             "type": [
              "string",
              "null"
             ]
            },
            "url": {
             "type": [
              "string",
              "null"
             ]
            },
            "api": {
             "type": [
              "string",
              "null"
             ]
            }
           }
          },
          "location": {
           "type": "object",
           "properties": {
            "area": {
             "type": [
              "string",
              "null"
             ]
            },
            "market": {
             "type": "string"
            },
            "country": {
             "type": "string"
            }
           }
          },
          "stage": {
           "type": [
            "string",
            "null"
           ],
           "description": "off-plan, under construction or completed, as published"
          },
          "site_status": {
           "type": [
            "string",
            "null"
           ]
          },
          "reviewed": {
           "type": "boolean",
           "description": "false: not yet reviewed by Kolaboro; review is null and no score is given"
          },
          "added": {
           "type": [
            "string",
            "null"
           ],
           "format": "date"
          },
          "last_checked": {
           "type": "string",
           "format": "date"
          },
          "published_page": {
           "type": [
            "object",
            "null"
           ],
           "properties": {
            "url": {
             "type": "string"
            },
            "host": {
             "type": "string"
            },
            "is_listing_portal": {
             "type": "boolean"
            }
           }
          },
          "permit": {
           "type": "object",
           "properties": {
            "number": {
             "type": [
              "string",
              "null"
             ]
            },
            "source": {
             "type": [
              "string",
              "null"
             ]
            },
            "note": {
             "type": [
              "string",
              "null"
             ],
             "example": "not published"
            }
           }
          },
          "handover": {
           "type": [
            "object",
            "null"
           ],
           "properties": {
            "date": {
             "type": "string",
             "example": "2027-Q2"
            },
            "source": {
             "type": [
              "string",
              "null"
             ]
            }
           }
          },
          "overdue_months": {
           "type": [
            "integer",
            "null"
           ]
          },
          "promises": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "kind": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "status": {
              "type": "string",
              "enum": [
               "pending",
               "kept",
               "broken",
               "moved"
              ]
             },
             "times_moved": {
              "type": "integer"
             },
             "months_moved": {
              "type": "integer"
             },
             "source": {
              "type": "string"
             },
             "first_seen": {
              "type": "string"
             },
             "last_seen": {
              "type": "string"
             },
             "history": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "date": {
                 "type": "string"
                },
                "seen": {
                 "type": "string"
                }
               }
              }
             }
            }
           }
          },
          "published_facts": {
           "type": "object",
           "description": "What the developer or listing publishes (prices, sizes, payment plan, developer facts), in source wording"
          },
          "published_statements": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "facts_source": {
           "type": [
            "string",
            "null"
           ]
          },
          "change_history": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "date": {
              "type": "string"
             },
             "field": {
              "type": "string"
             },
             "from": {},
             "to": {},
             "source": {
              "type": [
               "string",
               "null"
              ]
             }
            }
           }
          },
          "hourly_findings": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "at": {
              "type": "string",
              "format": "date-time"
             },
             "text": {
              "type": "string"
             },
             "page_sha256_prefix": {
              "type": [
               "string",
               "null"
              ]
             }
            }
           }
          },
          "sealed_copy": {
           "type": [
            "object",
            "null"
           ],
           "properties": {
            "date": {
             "type": "string"
            },
            "sha256": {
             "type": "string"
            },
            "verify": {
             "type": "string"
            }
           }
          },
          "register": {
           "type": [
            "object",
            "null"
           ]
          },
          "public_reports": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "kind": {
              "type": "string"
             },
             "url": {
              "type": "string"
             }
            }
           }
          },
          "review": {
           "type": [
            "object",
            "null"
           ],
           "description": "Only when reviewed is true: score, verification levels and claim counts"
          },
          "sources": {
           "type": "array",
           "items": {
            "type": "string",
            "format": "uri"
           }
          },
          "urls": {
           "type": "object",
           "properties": {
            "page": {
             "type": "string"
            },
            "pages": {
             "type": "object",
             "description": "the page in each of the 8 languages"
            },
            "feed_atom": {
             "type": "string"
            },
            "feed_json": {
             "type": "string"
            },
            "record": {
             "type": "string"
            },
            "watch": {
             "type": "string"
            },
            "reply": {
             "type": "string"
            },
            "corrections": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     },
     "304": {
      "description": "Not modified (If-None-Match matched)",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       }
      }
     },
     "404": {
      "description": "No named project or developer at this slug",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "string",
           "example": "not_found"
          },
          "note": {
           "type": "string"
          }
         }
        }
       }
      }
     },
     "429": {
      "description": "Rate limited (120 per minute per IP)",
      "headers": {
       "Retry-After": {
        "schema": {
         "type": "integer"
        }
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "string",
           "example": "rate_limited"
          },
          "retry_after_s": {
           "type": "integer"
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/developers": {
   "get": {
    "tags": [
     "Named projects"
    ],
    "summary": "All developers",
    "operationId": "v1_developers",
    "security": [],
    "parameters": [
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "ETag from an earlier response; answered with 304 when unchanged."
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       },
       "Cache-Control": {
        "schema": {
         "type": "string"
        },
        "description": "public, max-age=300 (900 for lists and the search index)"
       },
       "X-RateLimit-Limit": {
        "schema": {
         "type": "string"
        },
        "description": "120;w=60"
       },
       "X-RateLimit-Remaining": {
        "schema": {
         "type": "integer"
        }
       },
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "count": {
           "type": "integer"
          },
          "developers": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "slug": {
              "type": "string"
             },
             "name": {
              "type": "string"
             },
             "projects": {
              "type": "integer"
             },
             "api": {
              "type": "string"
             }
            }
           }
          }
         }
        }
       }
      }
     },
     "304": {
      "description": "Not modified (If-None-Match matched)",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       }
      }
     },
     "429": {
      "description": "Rate limited (120 per minute per IP)",
      "headers": {
       "Retry-After": {
        "schema": {
         "type": "integer"
        }
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "string",
           "example": "rate_limited"
          },
          "retry_after_s": {
           "type": "integer"
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/developers/{slug}": {
   "get": {
    "tags": [
     "Named projects"
    ],
    "summary": "One developer and its named projects",
    "operationId": "v1_developer",
    "security": [],
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "description": "Developer slug as in /developers/{slug}/",
      "schema": {
       "type": "string",
       "pattern": "^[a-z0-9-]{1,90}$"
      },
      "example": "teus-group"
     },
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "ETag from an earlier response; answered with 304 when unchanged."
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       },
       "Cache-Control": {
        "schema": {
         "type": "string"
        },
        "description": "public, max-age=300 (900 for lists and the search index)"
       },
       "X-RateLimit-Limit": {
        "schema": {
         "type": "string"
        },
        "description": "120;w=60"
       },
       "X-RateLimit-Remaining": {
        "schema": {
         "type": "integer"
        }
       },
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "slug": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "last_checked": {
           "type": "string"
          },
          "markets": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "projects": {
           "type": "array",
           "items": {
            "type": "object"
           }
          },
          "urls": {
           "type": "object"
          }
         }
        }
       }
      }
     },
     "304": {
      "description": "Not modified (If-None-Match matched)",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       }
      }
     },
     "404": {
      "description": "No named project or developer at this slug",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "string",
           "example": "not_found"
          },
          "note": {
           "type": "string"
          }
         }
        }
       }
      }
     },
     "429": {
      "description": "Rate limited (120 per minute per IP)",
      "headers": {
       "Retry-After": {
        "schema": {
         "type": "integer"
        }
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "string",
           "example": "rate_limited"
          },
          "retry_after_s": {
           "type": "integer"
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/search-index": {
   "get": {
    "tags": [
     "Named projects"
    ],
    "summary": "Compact search index of named projects and developers",
    "description": "Arrays of [slug, name, id, developer, developer_slug, market, country, area] and [slug, name, projects, markets]. Used by the instant search on /projects/ and the site search palette.",
    "operationId": "v1_search_index",
    "security": [],
    "parameters": [
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "ETag from an earlier response; answered with 304 when unchanged."
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       },
       "Cache-Control": {
        "schema": {
         "type": "string"
        },
        "description": "public, max-age=300 (900 for lists and the search index)"
       },
       "X-RateLimit-Limit": {
        "schema": {
         "type": "string"
        },
        "description": "120;w=60"
       },
       "X-RateLimit-Remaining": {
        "schema": {
         "type": "integer"
        }
       },
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "version": {
           "type": "string"
          },
          "updated": {
           "type": "string"
          },
          "counts": {
           "type": "object"
          },
          "fields": {
           "type": "object"
          },
          "p": {
           "type": "array",
           "items": {
            "type": "array"
           }
          },
          "d": {
           "type": "array",
           "items": {
            "type": "array"
           }
          }
         }
        }
       }
      }
     },
     "304": {
      "description": "Not modified (If-None-Match matched)",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       }
      }
     },
     "429": {
      "description": "Rate limited (120 per minute per IP)",
      "headers": {
       "Retry-After": {
        "schema": {
         "type": "integer"
        }
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "string",
           "example": "rate_limited"
          },
          "retry_after_s": {
           "type": "integer"
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/changes": {
   "get": {
    "tags": [
     "Named projects"
    ],
    "summary": "Every dated change since a moment (incremental sync)",
    "description": "Oldest first: projects added, dates on record and their moves, changes seen on developer pages, register checks, sealed copies, satellite comparisons. Each change has a stable id. Keep the \"at\" of the last change you stored and call again with since=<that at>, or follow \"next\" while has_more is true. ETag and Last-Modified; If-None-Match or If-Modified-Since answer 304 when nothing is new.",
    "operationId": "v1_changes",
    "security": [],
    "parameters": [
     {
      "name": "since",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "example": "2026-11-15",
      "description": "YYYY-MM-DD or ISO 8601 date-time; changes strictly after it"
     },
     {
      "name": "cursor",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "next_cursor of the previous page"
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 1000,
       "default": 500
      }
     },
     {
      "name": "project",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "slug or id of one project"
     },
     {
      "name": "market",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "market or country name"
     },
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "ETag from an earlier response; answered with 304 when unchanged."
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit-Policy": {
        "description": "IETF draft format: \"ip\";q=120;w=60",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit": {
        "description": "IETF draft format: \"ip\";r=<remaining>;t=<seconds to reset>",
        "schema": {
         "type": "string"
        }
       },
       "X-RateLimit-Limit": {
        "schema": {
         "type": "string"
        },
        "description": "120;w=60"
       },
       "X-RateLimit-Remaining": {
        "schema": {
         "type": "integer"
        }
       },
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       },
       "Last-Modified": {
        "description": "Time of the newest change; send If-Modified-Since to get 304.",
        "schema": {
         "type": "string"
        }
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "api": {
           "type": "string",
           "example": "kolaboro-changes-v1"
          },
          "count": {
           "type": "integer"
          },
          "has_more": {
           "type": "boolean"
          },
          "next_cursor": {
           "type": [
            "string",
            "null"
           ]
          },
          "next": {
           "type": [
            "string",
            "null"
           ]
          },
          "last_change_at": {
           "type": "string"
          },
          "changes": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string"
             },
             "at": {
              "type": "string",
              "format": "date-time"
             },
             "kind": {
              "type": "string"
             },
             "project": {
              "type": "object"
             },
             "title": {
              "type": "string"
             },
             "text": {
              "type": "string"
             },
             "source": {
              "type": [
               "string",
               "null"
              ]
             },
             "url": {
              "type": "string"
             }
            }
           }
          }
         }
        }
       }
      }
     },
     "304": {
      "description": "Not modified"
     },
     "429": {
      "description": "Rate limited; see Retry-After"
     }
    }
   }
  },
  "/api/v1/changes/feed.json": {
   "get": {
    "tags": [
     "Named projects"
    ],
    "summary": "The newest 100 changes as JSON Feed 1.1",
    "description": "Same records as /api/v1/changes, newest first, in JSON Feed 1.1 for feed readers.",
    "operationId": "v1_changes_feed",
    "security": [],
    "parameters": [
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "ETag from an earlier response; answered with 304 when unchanged."
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit-Policy": {
        "description": "IETF draft format: \"ip\";q=120;w=60",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit": {
        "description": "IETF draft format: \"ip\";r=<remaining>;t=<seconds to reset>",
        "schema": {
         "type": "string"
        }
       },
       "X-RateLimit-Limit": {
        "schema": {
         "type": "string"
        },
        "description": "120;w=60"
       },
       "X-RateLimit-Remaining": {
        "schema": {
         "type": "integer"
        }
       },
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       },
       "Last-Modified": {
        "description": "Time of the newest change; send If-Modified-Since to get 304.",
        "schema": {
         "type": "string"
        }
       }
      },
      "content": {
       "application/feed+json": {
        "schema": {
         "type": "object",
         "properties": {}
        }
       }
      }
     },
     "304": {
      "description": "Not modified"
     },
     "429": {
      "description": "Rate limited; see Retry-After"
     }
    }
   }
  },
  "/api/v1/projects/{slug}/certificate": {
   "get": {
    "tags": [
     "Named projects"
    ],
    "summary": "Verification certificate of one project",
    "description": "The facts on record as canonical JSON (keys sorted, no spaces) with their SHA-256, the SHA-256 of the dataset files they come from, the head of the daily snapshot chain and a link to the live check. signature.value is base64 Ed25519 over \"kolaboro-sig-v1\\n\" + SHA-256 hex of the canonical JSON of \"certificate\" (public keys: /.well-known/kolaboro-keys.json); alg \"none\" means hash only. Not a verdict about the project and not a guarantee.",
    "operationId": "v1_certificate",
    "security": [],
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "pattern": "^[a-z0-9-]{1,90}$"
      },
      "example": "coco-hills"
     },
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "ETag from an earlier response; answered with 304 when unchanged."
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit-Policy": {
        "description": "IETF draft format: \"ip\";q=120;w=60",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit": {
        "description": "IETF draft format: \"ip\";r=<remaining>;t=<seconds to reset>",
        "schema": {
         "type": "string"
        }
       },
       "X-RateLimit-Limit": {
        "schema": {
         "type": "string"
        },
        "description": "120;w=60"
       },
       "X-RateLimit-Remaining": {
        "schema": {
         "type": "integer"
        }
       },
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "certificate": {
           "type": "object",
           "properties": {
            "type": {
             "type": "string",
             "example": "kolaboro-project-certificate-v1"
            },
            "issued": {
             "type": "string",
             "format": "date"
            },
            "facts": {
             "type": "object"
            },
            "facts_sha256": {
             "type": "string"
            },
            "dataset": {
             "type": "object"
            },
            "live_check": {
             "type": "string"
            }
           }
          },
          "signature": {
           "type": "object",
           "properties": {
            "alg": {
             "type": "string",
             "enum": [
              "Ed25519",
              "none"
             ]
            },
            "kid": {
             "type": "string"
            },
            "value": {
             "type": "string"
            },
            "certificate_sha256": {
             "type": "string"
            }
           }
          }
         }
        }
       }
      }
     },
     "304": {
      "description": "Not modified"
     },
     "429": {
      "description": "Rate limited; see Retry-After"
     }
    }
   }
  },
  "/api/v1/developers/{slug}/website": {
   "get": {
    "tags": [
     "Named projects"
    ],
    "summary": "A developer's websites: daily health, certificate, domain registration",
    "description": "Per domain: the daily homepage check (status, response time, 30-day history, TLS expiry, domain expiry, Last-Modified, newest sitemap date) and forensics: registration date and registrar from the registry RDAP, issuer and issue date of the newest unexpired certificate from the certificate transparency logs, each with the date it was read.",
    "operationId": "v1_developer_website",
    "security": [],
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "pattern": "^[a-z0-9-]{1,90}$"
      },
      "example": "coco-development-group",
      "description": "Developer slug as in /developers/{slug}/"
     },
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "ETag from an earlier response; answered with 304 when unchanged."
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit-Policy": {
        "description": "IETF draft format: \"ip\";q=120;w=60",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit": {
        "description": "IETF draft format: \"ip\";r=<remaining>;t=<seconds to reset>",
        "schema": {
         "type": "string"
        }
       },
       "X-RateLimit-Limit": {
        "schema": {
         "type": "string"
        },
        "description": "120;w=60"
       },
       "X-RateLimit-Remaining": {
        "schema": {
         "type": "integer"
        }
       },
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {}
        }
       }
      }
     },
     "304": {
      "description": "Not modified"
     },
     "429": {
      "description": "Rate limited; see Retry-After"
     }
    }
   }
  },
  "/api/v1/snapshots": {
   "get": {
    "tags": [
     "Open data"
    ],
    "summary": "Daily dataset hash chain",
    "description": "One entry per UTC day on which /data/named.json was published: SHA-256 and size of the exact bytes, the previous head and this head = SHA-256 of \"kolaboro-snapshot-v1|day|/data/named.json|sha256|bytes|prev\", and a gzip copy of that day's file. provisional_tip is the file served now when it is newer than the last entry. Signed in x-kolaboro-signature.",
    "operationId": "v1_snapshots",
    "security": [],
    "parameters": [
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "ETag from an earlier response; answered with 304 when unchanged."
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit-Policy": {
        "description": "IETF draft format: \"ip\";q=120;w=60",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit": {
        "description": "IETF draft format: \"ip\";r=<remaining>;t=<seconds to reset>",
        "schema": {
         "type": "string"
        }
       },
       "X-RateLimit-Limit": {
        "schema": {
         "type": "string"
        },
        "description": "120;w=60"
       },
       "X-RateLimit-Remaining": {
        "schema": {
         "type": "integer"
        }
       },
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       },
       "x-kolaboro-signature": {
        "description": "base64 Ed25519 over 'kolaboro-sig-v1\\n' + SHA-256 hex of the body (when the signing key is configured)",
        "schema": {
         "type": "string"
        }
       },
       "x-kolaboro-key-id": {
        "schema": {
         "type": "string"
        }
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {}
        }
       }
      }
     },
     "304": {
      "description": "Not modified"
     },
     "429": {
      "description": "Rate limited; see Retry-After"
     }
    }
   }
  },
  "/api/v1/data-quality": {
   "get": {
    "tags": [
     "Open data"
    ],
    "summary": "Coverage and freshness of every field, by market",
    "description": "Share of named projects with each field (with its source), days since each project was last checked, and the same by market (10+ projects). Computed from the published dataset; method in the answer.",
    "operationId": "v1_data_quality",
    "security": [],
    "parameters": [
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "ETag from an earlier response; answered with 304 when unchanged."
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit-Policy": {
        "description": "IETF draft format: \"ip\";q=120;w=60",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit": {
        "description": "IETF draft format: \"ip\";r=<remaining>;t=<seconds to reset>",
        "schema": {
         "type": "string"
        }
       },
       "X-RateLimit-Limit": {
        "schema": {
         "type": "string"
        },
        "description": "120;w=60"
       },
       "X-RateLimit-Remaining": {
        "schema": {
         "type": "integer"
        }
       },
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {}
        }
       }
      }
     },
     "304": {
      "description": "Not modified"
     },
     "429": {
      "description": "Rate limited; see Retry-After"
     }
    }
   }
  },
  "/api/v1/openapi.json": {
   "get": {
    "tags": [
     "Open data"
    ],
    "summary": "OpenAPI 3.1 description of API v1",
    "description": "The /api/v1 part of this file, served with the v1 limits.",
    "operationId": "v1_openapi",
    "security": [],
    "parameters": [
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "ETag from an earlier response; answered with 304 when unchanged."
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "ETag": {
        "description": "Strong validator of the body; send it back as If-None-Match.",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit-Policy": {
        "description": "IETF draft format: \"ip\";q=120;w=60",
        "schema": {
         "type": "string"
        }
       },
       "RateLimit": {
        "description": "IETF draft format: \"ip\";r=<remaining>;t=<seconds to reset>",
        "schema": {
         "type": "string"
        }
       },
       "X-RateLimit-Limit": {
        "schema": {
         "type": "string"
        },
        "description": "120;w=60"
       },
       "X-RateLimit-Remaining": {
        "schema": {
         "type": "integer"
        }
       },
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {}
        }
       }
      }
     },
     "304": {
      "description": "Not modified"
     },
     "429": {
      "description": "Rate limited; see Retry-After"
     }
    }
   }
  }
 },
 "components": {
  "securitySchemes": {
   "apiKey": {
    "type": "apiKey",
    "in": "header",
    "name": "x-api-key",
    "description": "Free key from https://kolaboro.com/api-keys/ (kb_live_...), or the public sandbox key kb_sandbox_public (small pages, hourly limit per IP address)."
   }
  },
  "schemas": {
   "Error": {
    "type": "object",
    "properties": {
     "error": {
      "type": "string"
     }
    },
    "required": [
     "error"
    ]
   }
  }
 }
}