Geoapify · Schema
BatchGeocodeSearchResults
GeocodingGeospatialLocationMapsRoutingPlacesTimezoneMCPGeoJSONOpenStreetMapStatic MapsIsolines
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/geoapify/json-schema/geoapify-batch-geocode-search-results-schema.json",
"title": "BatchGeocodeSearchResults",
"x-generated": "2026-11-05",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/geoapify-batch-geocoding-api-openapi.yml#/components/schemas/BatchGeocodeSearchResults",
"type": "array",
"items": {
"$ref": "#/$defs/BatchGeocodeSearchResult"
},
"$defs": {
"BatchGeocodeSearchQuery": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"plus_code": {
"type": "string"
},
"text": {
"type": "string"
},
"postcode": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country": {
"type": "string"
},
"housenumber": {
"type": "string"
},
"street": {
"type": "string"
},
"parsed": {
"$ref": "#/$defs/GeocodingParsedAddress"
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"keys",
"label"
],
"properties": {
"keys": {
"type": "array",
"items": {
"type": "string"
}
},
"label": {
"type": "string"
}
}
}
}
},
"required": [
"text"
]
},
"BatchGeocodeSearchResult": {
"type": "object",
"required": [
"query"
],
"properties": {
"name": {
"type": "string"
},
"continent": {
"type": "string"
},
"country": {
"type": "string"
},
"country_code": {
"type": "string"
},
"region": {
"type": "string"
},
"state": {
"type": "string"
},
"state_code": {
"type": "string"
},
"state_COG": {
"type": "string"
},
"department_COG": {
"type": "string"
},
"state_district": {
"type": "string"
},
"province": {
"type": "string"
},
"department": {
"type": "string"
},
"arrondissement": {
"type": "string"
},
"county": {
"type": "string"
},
"county_code": {
"type": "string"
},
"county_district": {
"type": "string"
},
"city": {
"type": "string"
},
"city_district": {
"type": "string"
},
"postcode": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"openGeoDB:postal_codes": {
"type": "string"
},
"district": {
"type": "string"
},
"suburb": {
"type": "string"
},
"municipality": {
"type": "string"
},
"commune": {
"type": "string"
},
"subdistrict": {
"type": "string"
},
"city_block": {
"type": "string"
},
"neighbourhood": {
"type": "string"
},
"quarter": {
"type": "string"
},
"section": {
"type": "string"
},
"sector": {
"type": "string"
},
"subdivision": {
"type": "string"
},
"croft": {
"type": "string"
},
"allotments": {
"type": "string"
},
"residental": {
"type": "string"
},
"farm": {
"type": "string"
},
"farmyard": {
"type": "string"
},
"industrial": {
"type": "string"
},
"commercial": {
"type": "string"
},
"retail": {
"type": "string"
},
"borough": {
"type": "string"
},
"town": {
"type": "string"
},
"township": {
"type": "string"
},
"village": {
"type": "string"
},
"hamlet": {
"type": "string"
},
"locality": {
"type": "string"
},
"isolated_dwelling": {
"type": "string"
},
"street": {
"type": "string"
},
"road": {
"type": "string"
},
"footway": {
"type": "string"
},
"pedestrian": {
"type": "string"
},
"path": {
"type": "string"
},
"housenumber": {
"type": "string"
},
"house_number": {
"type": "string"
},
"house_name": {
"type": "string"
},
"old_name": {
"type": "string"
},
"other": {
"type": "string"
},
"formatted": {
"type": "string"
},
"address_line1": {
"type": "string"
},
"address_line2": {
"type": "string"
},
"unlocode": {
"type": "string"
},
"iso3166_2": {
"type": "string"
},
"iso3166_2_sublevel": {
"type": "string"
},
"iso3166_sublevel": {
"type": "string"
},
"plus_code": {
"type": "string"
},
"plus_code_short": {
"type": "string"
},
"postcodes": {
"type": "array",
"items": {
"type": "string"
}
},
"other_names": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"population": {
"type": "number"
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"parent_as_place_id": {
"type": "boolean"
},
"timezone": {
"$ref": "#/$defs/GeocodingTimezoneOutput"
},
"NUTS_3": {
"type": "string"
},
"result_type": {
"type": "string",
"enum": [
"unknown",
"amenity_name",
"amenity",
"building",
"street",
"postcode",
"suburb",
"district",
"city",
"county",
"state",
"country"
]
},
"distance": {
"type": "number"
},
"datasource": {
"$ref": "#/$defs/GeocodingPublicDatasource"
},
"rank": {
"$ref": "#/$defs/GeocodingGeocodingRank"
},
"category": {
"type": "string"
},
"categories": {
"type": "array",
"items": {
"type": "string"
}
},
"place_id": {
"type": "string",
"minLength": 3,
"maxLength": 2048
},
"bbox": {
"type": "object",
"required": [
"lon1",
"lat1",
"lon2",
"lat2"
],
"properties": {
"lon1": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"lat1": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon2": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"lat2": {
"type": "number",
"minimum": -90,
"maximum": 90
}
}
},
"query": {
"$ref": "#/$defs/BatchGeocodeSearchQuery"
}
}
},
"GeocodingGeocodingRank": {
"type": "object",
"properties": {
"confidence": {
"type": "number"
},
"confidence_city_level": {
"type": "number"
},
"confidence_street_level": {
"type": "number"
},
"confidence_building_level": {
"type": "number"
},
"match_type": {
"type": "string",
"enum": [
"full_match",
"inner_part",
"match_by_building",
"match_by_street",
"match_by_postcode",
"match_by_city_or_disrict",
"match_by_country_or_state"
]
},
"importance": {
"type": "number"
},
"popularity": {
"type": "number"
}
}
},
"GeocodingParsedAddress": {
"type": "object",
"properties": {
"po_box": {
"type": "string"
},
"unit": {
"type": "string"
},
"house": {
"type": "string"
},
"housenumber": {
"type": "string"
},
"street": {
"type": "string"
},
"suburb": {
"type": "string"
},
"postcode": {
"type": "string"
},
"district": {
"type": "string"
},
"city": {
"type": "string"
},
"county": {
"type": "string"
},
"state": {
"type": "string"
},
"region": {
"type": "string"
},
"country": {
"type": "string"
},
"expected_type": {
"type": "string",
"enum": [
"unknown",
"amenity_name",
"amenity",
"building",
"street",
"postcode",
"suburb",
"district",
"city",
"county",
"state",
"country"
]
}
}
},
"GeocodingPublicDatasource": {
"type": "object",
"properties": {
"sourcename": {
"type": "string"
},
"attribution": {
"type": "string"
},
"license": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
}
}
},
"GeocodingTimezoneOutput": {
"type": "object",
"required": [
"name",
"offset_STD",
"offset_DST",
"offset_STD_seconds",
"offset_DST_seconds"
],
"properties": {
"name": {
"type": "string"
},
"name_alt": {
"type": "string"
},
"country_codes": {
"type": "array",
"items": {
"type": "string"
}
},
"offset_STD": {
"type": "string"
},
"offset_DST": {
"type": "string"
},
"offset_STD_seconds": {
"type": "number"
},
"offset_DST_seconds": {
"type": "number"
},
"abbreviation_STD": {
"type": "string"
},
"abbreviation_DST": {
"type": "string"
}
}
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/geoapify-batch-geocode-search-results"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.