# Postal Facilities

U.S. postal facilities, ZIP geography, address metadata, crosswalks, and historical post offices.

## Access

- Kind: api
- Audience: public
- Access: open
- Authentication: Public datasets require no authentication; licensed CMRA data is not exposed in this catalog.
- Lifecycle: active
- Observed health: degraded

## Integration links

- Base URL: https://postalfacilities.datasourceapi.com
- Documentation: https://postalfacilities.datasourceapi.com/api/v1/docs
- OpenAPI: https://postalfacilities.datasourceapi.com/api/v1/openapi.yaml
- Status: https://postalfacilities.datasourceapi.com/api/v1/status
- Repository: https://github.com/coopalliance/cca-postalfacilities
- Catalog metadata: https://services.datasourceapi.com/api/v1/services/postal-facilities

## Capabilities

- addresses
- postal-facilities
- postal-history
- zip-crosswalks

## Provenance and freshness

- United States Postal Service: PostalPro, Locations, and public address-related datasets. (https://postalpro.usps.com/)
- HUD-USPS ZIP crosswalk: Quarterly ZIP Code crosswalk data. (https://www.huduser.gov/portal/datasets/usps_crosswalk.html)

Update cadence: Daily release detection with a 30-minute automation poller.. Metadata last verified: 2026-09-03.


## Agent readiness

partial (64/100): OpenAPI and docs are available; several source datasets were stale at the last audit.

## Examples

### Service status

Inspect current source releases and freshness.

```http
GET https://postalfacilities.datasourceapi.com/api/v1/status
```