Get one custom layer
Returns the layer with its item_count and bbox (the extent of its items, null when it is empty). An unknown layer is 404.
This is our own API, not Geoapify-compatible. Every request costs 1 rivet.
apiKey<token>Your API key from the dashboard, sent as ?apiKey=<key>.
layer*stringLayer slug: lowercase letters, digits and underscores, 2 to 40 characters (^[a-z0-9_]{2,40}$).
^[a-z0-9_]{2,40}$The layer.
application/json- response
A custom layer. Columns that are null are omitted from the output.
slug*string^[a-z][a-z0-9_]{1,39}$kind*stringzone holds polygons, location holds points, cell holds H3 cell sets. Immutable.
"zone""location""cell"name*stringlength <= 200description?stringlength <= 2000source_name*stringDefault "The Graphite Lab".
length <= 200enabled*booleanAlways true here: disabled layers are not visible.
requires_attribution*booleanattribution?stringlength <= 500license?stringlength <= 200usage_restriction?stringlength <= 500source_url?stringabsence_note?stringlength <= 1000source_backed*booleantile_minzoom*integer0 <= value <= 22tile_maxzoom*integer0 <= value <= 22raw_minzoom*integer0 <= value <= 22overviews*stringAlways off for a cell layer.
"auto""off"metric_keys?array<string>items <= 50weight_key?stringh3_resolution?integerCell layers only. Immutable.
0 <= value <= 15cells_compacted?booleanCell layers only. 0 to 3. When the point's own cell has no zone, rings 1..N are tried and the nearest ring with a hit wins.
cell_value_keys?array<string>Cell layers only. Names of the per-cell integer values.
items <= 8fallback_rings?integerCell layers only.
0 <= value <= 3revision*integerBumped by every write to the layer or its items.
item_count*integeroverviews_status*bbox?array<number>|[west, south, east, north] of the items. Only on GET /custom/layers/{layer}; null when the layer is empty.
4 <= items <= 4created_at*stringdate-timeupdated_at*stringdate-timecurl -X GET 'https://api.data.graphitelab.ai/v1/custom/layers/dead_zones'{ "slug": "zz_docs_layer", "kind": "zone", "name": "Docs demo layer", "description": "A demo zone layer created by the docs check.", "source_name": "Example Co", "enabled": false, "requires_attribution": true, "attribution": "© Example Co", "license": "CC BY 4.0", "source_backed": false, "tile_minzoom": 0, "tile_maxzoom": 16, "raw_minzoom": 12, "overviews": "auto", "fallback_rings": 0, "revision": 1, "item_count": 0, "overviews_status": { "status": "none", "built_at": null }, "created_at": "2026-11-04T02:37:47.628Z", "updated_at": "2026-11-04T02:37:47.628Z"}