{
    "name": "San Antonio Building Permits API",
    "description": "Building permits issued by the City of San Antonio, aggregated, and published with the coverage rate of every field the aggregates are computed from.",
    "meta": {
        "built": "2026-08-28T01:54:33+00:00",
        "window": {
            "from": "2025-01-01",
            "to": "2026-08-21"
        },
        "source": {
            "name": "City of San Antonio - Building Permits (PERMITS ISSUED)",
            "dataset": "https://data.sanantonio.gov/dataset/building-permits",
            "resource": "c21106f9-3ef5-4f3a-8604-f992b4db7512",
            "api": "https://data.sanantonio.gov/api/3/action/datastore_search_sql"
        }
    },
    "headline": {
        "permits": 137425,
        "permits_with_valuation": 3044,
        "valuation_coverage_pct": 2.2,
        "declared_valuation_usd": 26758577451,
        "what_that_means": "The $26,758,577,451 figure is computed from 3,044 permits, which is 2.2% of the 137,425 issued. It is not a measure of construction in San Antonio."
    },
    "endpoints": [
        {
            "href": "https://brandshyp.org/api/v1/permits",
            "returns": "This discovery document"
        },
        {
            "href": "https://brandshyp.org/api/v1/permits/summary",
            "returns": "Citywide totals and coverage"
        },
        {
            "href": "https://brandshyp.org/api/v1/permits/types",
            "returns": "Per permit type, with coverage"
        },
        {
            "href": "https://brandshyp.org/api/v1/permits/districts",
            "returns": "Per council district, with coverage and the permits that cannot be placed on one"
        },
        {
            "href": "https://brandshyp.org/api/v1/permits/months",
            "returns": "Monthly issued volume"
        },
        {
            "href": "https://brandshyp.org/api/v1/permits/quality",
            "returns": "What the record does not contain. Read this one first."
        },
        {
            "href": "https://brandshyp.org/api/v1/permits/summary.csv",
            "returns": "The whole cube as tidy CSV"
        },
        {
            "href": "https://brandshyp.org/api/v1/permits/openapi.json",
            "returns": "OpenAPI 3.1 description"
        }
    ],
    "openapi": "https://brandshyp.org/api/v1/permits/openapi.json",
    "documentation": "https://brandshyp.org/san-antonio-building-permits/",
    "caveats": {
        "valuation_coverage": "Only a small minority of permits carry a declared valuation. Every dollar figure here is computed from that minority and is published beside its coverage rate. Do not quote one without the other.",
        "district_comparison": "A district with more recorded valuation is not necessarily building more. It may simply have had the field filled in more often. This record cannot tell the two apart.",
        "declared_not_actual": "Declared valuation is what an applicant declared at permit time. It is not an appraisal, a contract price, or a final construction cost.",
        "multi_value_district": "The council-district field is a comma-separated multi-value string. Permits spanning several districts are reported as their own category and their valuation is never divided between districts.",
        "district_zero": "District 0 is not a council district. It is extra-territorial or unassigned territory.",
        "coordinates_unusable": "The published coordinate columns mix two coordinate systems and contain sign and axis errors, so no point map is drawn from them. The audit of those columns is published instead.",
        "aggregate_only": "This tool aggregates only. The permit record names applicants, many of whom are private individuals, and no per-applicant figure is published anywhere in it.",
        "permit_is_intent": "A permit is a declaration of intent to build. It is not evidence that anything was built."
    }
}