--- title: "Images API" description: "API for serving and managing MapTiler Cloud images." --- > For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL. # Images API ## Images API reference Scalar API Reference - [ Introduction ](#description/introduction) - [ Images ](#tag/images) Close Group - Images - [ ImageJSON HTTP Method:  GET](#tag/images/GET/images/{imageId}/image.json) - [ XYZ tiles HTTP Method:  GET](#tag/images/GET/images/{imageId}/{z}/{x}/{y}) [Powered by Scalar](https://www.scalar.com) v1.0 OpenAPI 3.1.0 # MapTiler API [Support](mailto:support@maptiler.com) [](https://docs.maptiler.com/support/requests/) [Terms of Service](https://www.maptiler.com/terms/) Server Server:https://api.maptiler.com MapTiler API ## AuthenticationRequired Selected Auth Type: key Client Libraries Shell Ruby Node.js PHP Python MoreSelect from all clients Shell Curl ## Images ​Copy link Images Operations - get/images/{imageId}/image.json - get/images/{imageId}/{z}/{x}/{y} ### ImageJSON ​Copy link Auth Required JSON describing the metadata of the image. Can be used with MapTiler SDK to display the image. Path Parameters - imageIdCopy link to imageId Type: string required Identifier of the image. Responses - 200 application/json Request Example for get/images/_{imageId}_/image.json Shell Curl ```curl curl 'https://api.maptiler.com/images/{imageId}/image.json?key=YOUR_MAPTILER_API_KEY' ``` Copy Copy Test Request(get /images/{imageId}/image.json) Status: 200 Show Schema ```json { "id": "string", "description": "string", "attribution": "string", "width": 1, "height": 1, "minzoom": 1, "maxzoom": 1, "tileSize": 1 } ``` JSONCopy JSONCopy ### XYZ tiles ​Copy link Auth Required The individual tiles. Can be used with various libraries to display the image. It's better to use the ImageJSON with MapTiler SDK rather than using the tile URL directly. Path Parameters - imageIdCopy link to imageId Type: string required Identifier of the image. - zCopy link to z Type: integer required Zoom level. Specifies the tile's zoom level. See [Tiles à la Google Maps](https://docs.maptiler.com/google-maps-coordinates-tile-bounds-projection/) - xCopy link to x Type: integer required Column. Specifies the tile's column. See [Tiles à la Google Maps](https://docs.maptiler.com/google-maps-coordinates-tile-bounds-projection/) - yCopy link to y Type: integer required Row. Specifies the tile's row. See [Tiles à la Google Maps](https://docs.maptiler.com/google-maps-coordinates-tile-bounds-projection/) Responses - 200 \* - 204 Tile not present -- presumed empty (empty response) - 400 Out of bounds - 403 Key is missing, invalid or restricted - 404 The item does not exist Request Example for get/images/_{imageId}_/_{z}_/_{x}_/_{y}_ Shell Curl ```curl curl 'https://api.maptiler.com/images/{imageId}/1/1/1?key=YOUR_MAPTILER_API_KEY' ``` Copy Copy Test Request(get /images/{imageId}/{z}/{x}/{y}) Status: 200Status: 204Status: 400Status: 403Status: 404 No Body ![](https://docs.maptiler.com/assets/img/open-api.png) Using the OpenAPI Specification? Get the [openapi.yaml](https://docs.maptiler.com/_data/cloud/api/openapi.yml)