{"components":{"schemas":{"Bucket":{"additionalProperties":true,"properties":{"acquisition_status":{"type":"string"},"attribution":{"type":"string"},"coverage":{"$ref":"#/components/schemas/Coverage"},"freshness_checked_at":{"type":"string"},"license_notes":{"type":"string"},"limitations":{"description":"Source caveats and any attribution text required when reusing the records.","items":{"type":"string"},"type":"array"},"max_age_hours":{"minimum":0,"type":"number"},"next_page":{"description":"Relative URL for the next page in this immutable revision, or null after the last page. Never mix revisions.","type":["string","null"]},"page":{"type":"integer"},"page_count":{"type":"integer"},"preview":{"type":"boolean"},"record_count":{"description":"Number of published factual rows, not upstream inventory size.","minimum":0,"type":"integer"},"record_geography":{"items":{"type":"string"},"type":"array"},"records":{"description":"Allowlisted factual fields retaining source-specific identifiers. A city directory contains at most five preview rows; follow records_url for all published rows.","items":{"additionalProperties":true,"type":"object"},"type":"array"},"records_returned":{"minimum":0,"type":"integer"},"records_url":{"type":"string"},"records_withheld":{"description":"True means the underlying private rows are not published. Empty records must not be treated as a valid zero when this flag is true.","type":"boolean"},"refresh_status":{"enum":["refreshed","retained_after_failure"],"type":"string"},"revision":{"type":"string"},"scope_description":{"description":"Source-supplied coverage explanation or aggregate coverage metadata.","type":["string","object","null"]},"snapshot_at":{"description":"Source-specific ISO timestamp. Null means unknown or never acquired; retrieval time and source observation time are distinct.","type":["string","null"]},"source_id":{"type":"string"},"source_observed_at":{"description":"Source-specific ISO timestamp. Null means unknown or never acquired; retrieval time and source observation time are distinct.","type":["string","null"]},"source_period":{"type":["string","number","object","null"]},"source_url":{"type":"string"},"source_urls":{"items":{"type":"string"},"type":"array"},"stale":{"description":"Computed on every request from snapshot_at and the source TTL.","type":"boolean"}},"required":["source_id","records","snapshot_at","max_age_hours","coverage","refresh_status"],"type":"object"},"Catalog":{"additionalProperties":true,"properties":{"catalog_total":{"const":281},"city":{"type":"string"},"generated_at":{"description":"Source-specific ISO timestamp. Null means unknown or never acquired; retrieval time and source observation time are distinct.","type":["string","null"]},"records":{"items":{"$ref":"#/components/schemas/Source"},"type":"array"},"schema_version":{"const":1}},"required":["schema_version","catalog_total","records"],"type":"object"},"Coverage":{"additionalProperties":true,"description":"Coverage of the exact configured query. A bounded sample is not the full upstream dataset. A count or metadata reply is not a record feed.","properties":{"bounded":{"type":"boolean"},"complete":{"type":"boolean"},"pages":{"type":"integer"},"reported_total":{"type":["integer","null"]},"returned":{"type":"integer"}},"type":["object","null"]},"Error":{"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"},"Health":{"additionalProperties":true,"properties":{"catalog_total":{"const":281},"counts":{"additionalProperties":{"type":"integer"},"type":"object"},"generated_at":{"description":"Source-specific ISO timestamp. Null means unknown or never acquired; retrieval time and source observation time are distinct.","type":["string","null"]},"published_records":{"type":"integer"},"refresh_mode":{"const":"manual"},"schedule_installed":{"const":false},"schema_version":{"const":1},"service":{"const":"guide-data-api"},"snapshots":{"type":"integer"}},"required":["schema_version","service","catalog_total","snapshots","published_records","refresh_mode","schedule_installed"],"type":"object"},"Source":{"additionalProperties":true,"properties":{"access_class":{"description":"Structured response, valid-empty, document, file, metadata-only, credential-required and unresolved routes remain separate.","type":"string"},"attribution":{"type":"string"},"connector_configured":{"type":"boolean"},"coverage":{"$ref":"#/components/schemas/Coverage"},"id":{"type":"string"},"last_attempt_at":{"description":"Source-specific ISO timestamp. Null means unknown or never acquired; retrieval time and source observation time are distinct.","type":["string","null"]},"last_error":{"type":["string","null"]},"license_notes":{"type":"string"},"max_age_hours":{"type":"number"},"name":{"type":"string"},"priority":{"enum":["P0","P1","P2"]},"public_record_count":{"description":"Allowlisted rows available in the selected snapshot. Zero does not imply the upstream query was empty. Interpret with status.","minimum":0,"type":"integer"},"record_geography":{"items":{"type":"string"},"type":"array"},"scope_description":{"description":"Source-supplied coverage explanation or aggregate coverage metadata.","type":["string","object","null"]},"snapshot_at":{"description":"Source-specific ISO timestamp. Null means unknown or never acquired; retrieval time and source observation time are distinct.","type":["string","null"]},"source_observed_at":{"description":"Source-specific ISO timestamp. Null means unknown or never acquired; retrieval time and source observation time are distinct.","type":["string","null"]},"source_url":{"type":"string"},"stale":{"type":"boolean"},"status":{"description":"acquired_records, valid_empty, file_metadata, retained_after_failure, acquisition_failed, no_city_snapshot, not_acquired, or the source access class.","type":"string"},"stream_id":{"type":"string"}},"required":["id","stream_id","name","access_class","status","stale","public_record_count"],"type":"object"}}},"info":{"description":"Public read-only status and safe snapshots across three guides. Source availability, configured connectors and successfully acquired records are separate states. Refresh is manual; no recurring schedule is installed. Request bodies, credentials, raw full text and private records remain server-side. Dates use ISO timestamps; student display timezone is America/Chicago. Unknown values are null, never an invented zero.","title":"Campus Guide Shared Data API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/openapi.json":{"get":{"operationId":"ReadOpenAPI","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Validated public data or source status. Empty records are distinguished from unavailable/withheld data by status and coverage."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown route, source, revision or page. Reload the source directory after a revision changes."},"405":{"description":"Read-only service. Allowed methods: GET, HEAD, OPTIONS."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public snapshot; do not interpret this as zero records."}},"summary":"ReadOpenAPI"},"head":{"operationId":"ReadOpenAPIHeaders","parameters":[],"responses":{"200":{"description":"Same status and headers as GET, without a response body."},"404":{"description":"Unknown resource."},"503":{"description":"Invalid public snapshot."}},"summary":"Headers for ReadOpenAPI"}},"/v1/catalog":{"get":{"operationId":"ReadCatalog","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}},"description":"Validated public data or source status. Empty records are distinguished from unavailable/withheld data by status and coverage."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown route, source, revision or page. Reload the source directory after a revision changes."},"405":{"description":"Read-only service. Allowed methods: GET, HEAD, OPTIONS."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public snapshot; do not interpret this as zero records."}},"summary":"ReadCatalog"},"head":{"operationId":"ReadCatalogHeaders","parameters":[],"responses":{"200":{"description":"Same status and headers as GET, without a response body."},"404":{"description":"Unknown resource."},"503":{"description":"Invalid public snapshot."}},"summary":"Headers for ReadCatalog"}},"/v1/health":{"get":{"operationId":"ReadHealth","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}},"description":"Validated public data or source status. Empty records are distinguished from unavailable/withheld data by status and coverage."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown route, source, revision or page. Reload the source directory after a revision changes."},"405":{"description":"Read-only service. Allowed methods: GET, HEAD, OPTIONS."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public snapshot; do not interpret this as zero records."}},"summary":"ReadHealth"},"head":{"operationId":"ReadHealthHeaders","parameters":[],"responses":{"200":{"description":"Same status and headers as GET, without a response body."},"404":{"description":"Unknown resource."},"503":{"description":"Invalid public snapshot."}},"summary":"Headers for ReadHealth"}},"/v1/snapshots/{sourceId}":{"get":{"operationId":"ReadSnapshotFirstPage","parameters":[{"in":"path","name":"sourceId","required":true,"schema":{"description":"Grouped source ID such as shared:SH011, or an independently refreshed shared city variant such as shared:SH011.lubbock.","pattern":"^[A-Za-z0-9_:.-]+$","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bucket"}}},"description":"Validated public data or source status. Empty records are distinguished from unavailable/withheld data by status and coverage."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown route, source, revision or page. Reload the source directory after a revision changes."},"405":{"description":"Read-only service. Allowed methods: GET, HEAD, OPTIONS."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public snapshot; do not interpret this as zero records."}},"summary":"ReadSnapshotFirstPage"},"head":{"operationId":"ReadSnapshotFirstPageHeaders","parameters":[{"in":"path","name":"sourceId","required":true,"schema":{"description":"Grouped source ID such as shared:SH011, or an independently refreshed shared city variant such as shared:SH011.lubbock.","pattern":"^[A-Za-z0-9_:.-]+$","type":"string"}}],"responses":{"200":{"description":"Same status and headers as GET, without a response body."},"404":{"description":"Unknown resource."},"503":{"description":"Invalid public snapshot."}},"summary":"Headers for ReadSnapshotFirstPage"}},"/v1/snapshots/{sourceId}/{revision}/pages/{page}":{"get":{"operationId":"ReadSnapshotPage","parameters":[{"in":"path","name":"sourceId","required":true,"schema":{"description":"Grouped source ID such as shared:SH011, or an independently refreshed shared city variant such as shared:SH011.lubbock.","pattern":"^[A-Za-z0-9_:.-]+$","type":"string"}},{"in":"path","name":"revision","required":true,"schema":{"pattern":"^[a-f0-9]{16}$","type":"string"}},{"in":"path","name":"page","required":true,"schema":{"maximum":99999,"minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bucket"}}},"description":"Validated public data or source status. Empty records are distinguished from unavailable/withheld data by status and coverage."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown route, source, revision or page. Reload the source directory after a revision changes."},"405":{"description":"Read-only service. Allowed methods: GET, HEAD, OPTIONS."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public snapshot; do not interpret this as zero records."}},"summary":"ReadSnapshotPage"},"head":{"operationId":"ReadSnapshotPageHeaders","parameters":[{"in":"path","name":"sourceId","required":true,"schema":{"description":"Grouped source ID such as shared:SH011, or an independently refreshed shared city variant such as shared:SH011.lubbock.","pattern":"^[A-Za-z0-9_:.-]+$","type":"string"}},{"in":"path","name":"revision","required":true,"schema":{"pattern":"^[a-f0-9]{16}$","type":"string"}},{"in":"path","name":"page","required":true,"schema":{"maximum":99999,"minimum":0,"type":"integer"}}],"responses":{"200":{"description":"Same status and headers as GET, without a response body."},"404":{"description":"Unknown resource."},"503":{"description":"Invalid public snapshot."}},"summary":"Headers for ReadSnapshotPage"}},"/v1/{city}/collections":{"get":{"operationId":"ReadCityCollections","parameters":[{"in":"path","name":"city","required":true,"schema":{"enum":["college-station","lubbock","san-marcos"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"city":{"type":"string"},"collections":{"additionalProperties":{"$ref":"#/components/schemas/Bucket"},"type":"object"},"schema_version":{"const":1},"snapshot_at":{"description":"Source-specific ISO timestamp. Null means unknown or never acquired; retrieval time and source observation time are distinct.","type":["string","null"]}},"type":"object"}}},"description":"Validated public data or source status. Empty records are distinguished from unavailable/withheld data by status and coverage."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown route, source, revision or page. Reload the source directory after a revision changes."},"405":{"description":"Read-only service. Allowed methods: GET, HEAD, OPTIONS."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public snapshot; do not interpret this as zero records."}},"summary":"ReadCityCollections"},"head":{"operationId":"ReadCityCollectionsHeaders","parameters":[{"in":"path","name":"city","required":true,"schema":{"enum":["college-station","lubbock","san-marcos"],"type":"string"}}],"responses":{"200":{"description":"Same status and headers as GET, without a response body."},"404":{"description":"Unknown resource."},"503":{"description":"Invalid public snapshot."}},"summary":"Headers for ReadCityCollections"}},"/v1/{city}/sources":{"get":{"operationId":"ReadCitySources","parameters":[{"in":"path","name":"city","required":true,"schema":{"enum":["college-station","lubbock","san-marcos"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}},"description":"Validated public data or source status. Empty records are distinguished from unavailable/withheld data by status and coverage."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown route, source, revision or page. Reload the source directory after a revision changes."},"405":{"description":"Read-only service. Allowed methods: GET, HEAD, OPTIONS."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public snapshot; do not interpret this as zero records."}},"summary":"ReadCitySources"},"head":{"operationId":"ReadCitySourcesHeaders","parameters":[{"in":"path","name":"city","required":true,"schema":{"enum":["college-station","lubbock","san-marcos"],"type":"string"}}],"responses":{"200":{"description":"Same status and headers as GET, without a response body."},"404":{"description":"Unknown resource."},"503":{"description":"Invalid public snapshot."}},"summary":"Headers for ReadCitySources"}}},"servers":[{"description":"This verified API origin","url":"/"}]}