Skip to content
Close API

Per-category travel times

GET
/v1/blocks/{geoid}/summary

Fastest travel time from this block to each destination category, by mode. These are the same per-category minimums close.city shows.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
geoid
required
Geoid

15-digit census block GEOID

string
/^\d{15}$/

15-digit census block GEOID

Query Parameters

Section titled “Query Parameters”
mode
Any of:
Array<string>
type
Any of:
Array<integer>

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

BlockSummaryResponse

GET /v1/blocks/{geoid}/summary (routers.blocks.blocks_summary)

object
block
required
BlockMeta

Census-block metadata. (queries.blocks.summary_rows -> block_meta)

object
geoid
required
Geoid

15-digit census block GEOID

string
land_area_m2
Any of:
number
population
Any of:
integer
results
required
Results
Array<object>
CategoryTime

Fastest travel time to one destination category by one mode. (shape.shape_summary)

object
dest_type_id
required
Dest Type Id
integer
mode
required
Mode

Travel mode label, e.g. ‘walk’

string
travel_time
required
Travel Time

Minutes, capped at 30, 1 decimal

number
Example
{
  "block": {
    "geoid": "410390020001010",
    "land_area_m2": 183245,
    "population": 1187
  },
  "results": [
    {
      "dest_type_id": 30,
      "mode": "walk",
      "travel_time": 6.5
    },
    {
      "dest_type_id": 30,
      "mode": "transit",
      "travel_time": 11
    }
  ]
}

304

Section titled “304”

Not modified (If-None-Match matched the ETag); no body, no tokens charged

400

Section titled “400”

Invalid request (e.g. invalid-parameters, invalid-cursor, invalid-bbox, missing-location, missing-area, invalid-geometry, polygon-too-complex, missing-origins, too-many-origins)

ValidationProblem

400 invalid-parameters, carrying the offending fields. (core.problems, RequestValidationError handler)

object
detail
Any of:
string
errors
Any of:
Array<object>
ValidationErrorItem
object
loc
required
Loc
Array
msg
required
Msg
string
type
required
Type
string
status
required
Status
integer
title
required
Title
string
type
required
Type

Problem type URI; the final path segment is the stable slug

string
key
additional properties
any

401

Section titled “401”

Missing or invalid API key (missing-key, invalid-key)

Problem

RFC 9457 problem detail. Served as application/problem+json. Additional members appear for some problem types (e.g. errors). (core.problems.problem)

object
detail
Any of:
string
status
required
Status
integer
title
required
Title
string
type
required
Type

Problem type URI; the final path segment is the stable slug

string
key
additional properties
any

403

Section titled “403”

Key disabled (account-disabled)

Problem

RFC 9457 problem detail. Served as application/problem+json. Additional members appear for some problem types (e.g. errors). (core.problems.problem)

object
detail
Any of:
string
status
required
Status
integer
title
required
Title
string
type
required
Type

Problem type URI; the final path segment is the stable slug

string
key
additional properties
any

404

Section titled “404”

Resource not found (block-not-found, poi-not-found, place-not-found, point-not-covered, no-isochrone-data, direction-not-available)

Problem

RFC 9457 problem detail. Served as application/problem+json. Additional members appear for some problem types (e.g. errors). (core.problems.problem)

object
detail
Any of:
string
status
required
Status
integer
title
required
Title
string
type
required
Type

Problem type URI; the final path segment is the stable slug

string
key
additional properties
any

429

Section titled “429”

Rate limited or token balance exhausted (rate-limited, tokens-exhausted); sets Retry-After

Problem

RFC 9457 problem detail. Served as application/problem+json. Additional members appear for some problem types (e.g. errors). (core.problems.problem)

object
detail
Any of:
string
status
required
Status
integer
title
required
Title
string
type
required
Type

Problem type URI; the final path segment is the stable slug

string
key
additional properties
any

503

Section titled “503”

Backend temporarily unavailable (debit-unavailable, store-unavailable); may set Retry-After

Problem

RFC 9457 problem detail. Served as application/problem+json. Additional members appear for some problem types (e.g. errors). (core.problems.problem)

object
detail
Any of:
string
status
required
Status
integer
title
required
Title
string
type
required
Type

Problem type URI; the final path segment is the stable slug

string
key
additional properties
any