---
name: orthogonal-us-census-geocoder
description: "Call US Census Geocoder through Orthogonal's pay-per-use Run API: Geocode US and Puerto Rico addresses to latitude/longitude, and look up census state, county, tract, block and other geographies for an address or a coordinate, using the U.S. Census Bureau's public geocoding service. This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau."
---

# US Census Geocoder — Orthogonal API

> Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance.
> Base API: `https://api.orthogonal.com/v1/run` · [llms.txt](https://www.orthogonal.com/llms.txt) · [browse all APIs](https://www.orthogonal.com/catalog)

Geocode US and Puerto Rico addresses to latitude/longitude, and look up census state, county, tract, block and other geographies for an address or a coordinate, using the U.S. Census Bureau's public geocoding service. This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.

**Verified:** no

## Access

**Run API:** `POST https://api.orthogonal.com/v1/run`
**Auth:** `Authorization: Bearer $ORTHOGONAL_API_KEY`
Get an API key at https://www.orthogonal.com/account/keys

No account or key yet? Set up Orthogonal first with https://www.orthogonal.com/skill.md: it covers the CLI, the MCP server, the TypeScript SDK and sign-up, including an agent sign-up without a password (https://www.orthogonal.com/agent-signup.md).

Every call goes through the unified Run API: send the API `slug`, the endpoint `path`, and the `query`/`body` parameters. The response is `{ "success": true, "priceCents": <US cents>, "requestId": "...", "data": { ... } }`.

Quote first, free: the same request with `"dryRun": true` returns the price without calling the API or charging anything. On a retry after a timeout, send the same `Idempotency-Key` header so the call runs and bills once.

## Endpoints

### One-line address geocoding

Geocode a full single-line address to latitude/longitude and a matched, standardized address (returntype locations, searchtype onelineaddress).

`GET /locations/onelineaddress`

**Estimated cost:** $0.002

**Page:** https://www.orthogonal.com/api/us-census-geocoder/38abddd4-4cee-4305-acbf-8b592c974bdd

**Docs:** https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | A single line containing the full address to be searched. |
| `benchmark` | string | Yes | Numerical ID or name of the locator version, e.g. 4 or Public_AR_Current (see Benchmark list). |
| `format` | string | Yes | Output format. |
| `callback` | string | No | JSONP callback function name; use with format=jsonp. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"us-census-geocoder","path":"/locations/onelineaddress","method":"GET","query":{"address":"<string>","benchmark":"<string>","format":"<string>","callback":"<string>"}}'
```

### Address parts geocoding

Geocode an address given as separate street, city, state and ZIP parts (returntype locations, searchtype address). Needs street+zip or street+city+state.

`GET /locations/address`

**Estimated cost:** $0.002

**Page:** https://www.orthogonal.com/api/us-census-geocoder/899c4345-f31d-48da-9f12-16288f1d5f95

**Docs:** https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `street` | string | Yes | Structure number and street name. |
| `city` | string | No |  |
| `state` | string | No |  |
| `zip` | string | No |  |
| `benchmark` | string | Yes | Numerical ID or name of the locator version, e.g. 4 or Public_AR_Current. |
| `format` | string | Yes |  |
| `callback` | string | No | JSONP callback; use with format=jsonp. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"us-census-geocoder","path":"/locations/address","method":"GET","query":{"street":"<string>","city":"<string>","state":"<string>","zip":"<string>","benchmark":"<string>","format":"<string>","callback":"<string>"}}'
```

### Puerto Rico address geocoding

Geocode a Puerto Rico address split into parts, including urbanization and municipio (returntype locations, searchtype addressPR).

`GET /locations/addressPR`

**Estimated cost:** $0.002

**Page:** https://www.orthogonal.com/api/us-census-geocoder/859feb79-e3d7-43b5-940d-5dbf998b8078

**Docs:** https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `street` | string | Yes |  |
| `urb` | string | No | Urbanization. |
| `city` | string | No |  |
| `municipio` | string | No |  |
| `state` | string | No |  |
| `zip` | string | No | Should begin with 006, 007 or 009. |
| `benchmark` | string | Yes |  |
| `format` | string | Yes |  |
| `callback` | string | No |  |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"us-census-geocoder","path":"/locations/addressPR","method":"GET","query":{"street":"<string>","urb":"<string>","city":"<string>","municipio":"<string>","state":"<string>","zip":"<string>","benchmark":"<string>","format":"<string>","callback":"<string>"}}'
```

### One-line address with geographies

Geocode a single-line address and return the census geographies (state, county, tract, block and more) covering it (returntype geographies, searchtype onelineaddress).

`GET /geographies/onelineaddress`

**Estimated cost:** $0.002

**Page:** https://www.orthogonal.com/api/us-census-geocoder/11bfc1bb-7330-43d3-b70e-44a18db34823

**Docs:** https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes |  |
| `benchmark` | string | Yes |  |
| `vintage` | string | Yes | Numerical ID or name of the geography vintage, e.g. 4 or Current_Current (see Vintage list). |
| `layers` | string | No | Comma-delimited TIGERweb layer IDs or names, or all. |
| `format` | string | Yes |  |
| `callback` | string | No |  |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"us-census-geocoder","path":"/geographies/onelineaddress","method":"GET","query":{"address":"<string>","benchmark":"<string>","vintage":"<string>","layers":"<string>","format":"<string>","callback":"<string>"}}'
```

### Address parts with geographies

Geocode an address given in parts and return the census geographies covering it (returntype geographies, searchtype address).

`GET /geographies/address`

**Estimated cost:** $0.002

**Page:** https://www.orthogonal.com/api/us-census-geocoder/bd9d5234-efce-4b96-b427-f7217cad4300

**Docs:** https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `street` | string | Yes |  |
| `city` | string | No |  |
| `state` | string | No |  |
| `zip` | string | No |  |
| `benchmark` | string | Yes |  |
| `vintage` | string | Yes |  |
| `layers` | string | No |  |
| `format` | string | Yes |  |
| `callback` | string | No |  |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"us-census-geocoder","path":"/geographies/address","method":"GET","query":{"street":"<string>","city":"<string>","state":"<string>","zip":"<string>","benchmark":"<string>","vintage":"<string>","layers":"<string>","format":"<string>","callback":"<string>"}}'
```

### Puerto Rico address with geographies

Geocode a Puerto Rico address in parts and return the census geographies covering it (returntype geographies, searchtype addressPR).

`GET /geographies/addressPR`

**Estimated cost:** $0.002

**Page:** https://www.orthogonal.com/api/us-census-geocoder/22ec919d-d941-4e51-a00c-2c0b67d9aff4

**Docs:** https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `street` | string | Yes |  |
| `urb` | string | No |  |
| `city` | string | No |  |
| `municipio` | string | No |  |
| `state` | string | No |  |
| `zip` | string | No |  |
| `benchmark` | string | Yes |  |
| `vintage` | string | Yes |  |
| `layers` | string | No |  |
| `format` | string | Yes |  |
| `callback` | string | No |  |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"us-census-geocoder","path":"/geographies/addressPR","method":"GET","query":{"street":"<string>","urb":"<string>","city":"<string>","municipio":"<string>","state":"<string>","zip":"<string>","benchmark":"<string>","vintage":"<string>","layers":"<string>","format":"<string>","callback":"<string>"}}'
```

### Coordinate geography lookup

Return the census geographies (state, county, tract, block and more) covering a longitude/latitude point (returntype geographies, searchtype coordinates).

`GET /geographies/coordinates`

**Estimated cost:** $0.002

**Page:** https://www.orthogonal.com/api/us-census-geocoder/63f37f1c-7708-4773-b173-1a5826288176

**Docs:** https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `x` | number | Yes | Longitude, decimal. |
| `y` | number | Yes | Latitude, decimal. |
| `benchmark` | string | Yes |  |
| `vintage` | string | Yes |  |
| `layers` | string | No |  |
| `format` | string | Yes |  |
| `callback` | string | No |  |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"us-census-geocoder","path":"/geographies/coordinates","method":"GET","query":{"x":"<number>","y":"<number>","benchmark":"<string>","vintage":"<string>","layers":"<string>","format":"<string>","callback":"<string>"}}'
```

### Benchmark list

List the available locator benchmarks (IDs and names) to pass as benchmark.

`GET /benchmarks`

**Estimated cost:** $0.002

**Page:** https://www.orthogonal.com/api/us-census-geocoder/2dedec32-55e2-4921-8c57-816fbc2270fd

**Docs:** https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `format` | string | No | Output format (unsourced: the docs link this page without parameters). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"us-census-geocoder","path":"/benchmarks","method":"GET","query":{"format":"<string>"}}'
```

### Vintage list

List the geography vintages available for a benchmark, to pass as vintage.

`GET /vintages`

**Estimated cost:** $0.002

**Page:** https://www.orthogonal.com/api/us-census-geocoder/66f85fd4-c985-49a0-9259-92c2ba9a4279

**Docs:** https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `benchmark` | string | Yes |  |
| `format` | string | No | Output format (unsourced). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"us-census-geocoder","path":"/vintages","method":"GET","query":{"benchmark":"<string>","format":"<string>"}}'
```

---

Full details and an interactive quickstart: https://www.orthogonal.com/publisher/us-census-geocoder
