Print Exports

APIs to export map images

With these APIs, you can render a map to a PNG, JPG or PDF image.

Export map as image

post

Render the map to a PNG, JPG or PDF image at a chosen size and view — what the app's "Export as image" produces, without a browser.

The request waits up to 55 seconds and returns 200 with a completed export. Follow download_url to download the file before expires_at. Invalid requests return 4xx; rendering failures return 503, and a render that exceeds the request deadline returns 504. There is no polling endpoint.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

map_idstringRequired

The ID of the map to export

Body

Output settings, geographic view and legend options for a map image export.

show_scale_barbooleanOptional

Draw the scale bar. Attribution is always drawn. Defaults to true.

Default: true

viewone ofOptional

Choose exactly one of bounds or viewport. Omit view to use the map's default view.

or

Responses

200

Completed image export

application/json

download_urlstringRequired

A URL for the finished image; it redirects to the file, so follow redirects. Expires at expires_at.

Example: https://felt.com/map-image-exports/auFxn9BO4RrGGiKrGfaS7ZB/download

expires_atstring · date-timeRequired

When download_url stops working.

Example: 2026-08-28T19:04:11Z

filenamestringRequiredExample: My map.png

idstring · felt_idRequiredExample: luCHyMruTQ6ozGk3gPJfEB

rendered_boundsnumber[] · min: 4 · max: 4Required

The [west, south, east, north] the image actually covers — the requested view.bounds fitted to the canvas's aspect ratio, or the viewport's frame. Adjust framing from this rather than by measuring pixels. An east west of west crosses the antimeridian.

Example: [-129,41.25,-116.1,47.03]

401

UnauthorizedError

application/json

403

UnauthorizedError

application/json

404

NotFoundError

application/json

422

Unprocessable Entity

application/json

429

Unprocessable Entity

application/json

500

InternalServerError

application/json

503

ServiceUnavailableError

application/json

504

Gateway timeout

application/json

post/api/v2/maps/{map_id}/image_exports

POST /api/v2/maps/{map_id}/image_exports HTTP/1.1
Host: felt.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 254

{
  "legend": {
    "show_components": true,
    "show_description": true,
    "show_title": true,
    "visible": true
  },
  "output": {
    "format": "png",
    "height_px": 1500,
    "jpg_quality": 0.9,
    "pixel_ratio": 2,
    "width_px": 2000
  },
  "show_scale_bar": true,
  "view": {
    "bounds": [
      -122.52,
      37.7,
      -122.35,
      37.83
    ]
  }
}

{
  "download_url": "https://felt.com/map-image-exports/auFxn9BO4RrGGiKrGfaS7ZB/download",
  "expires_at": "2026-08-28T19:04:11Z",
  "filename": "My map.png",
  "id": "luCHyMruTQ6ozGk3gPJfEB",
  "output": {
    "format": "png",
    "height_px": 1500,
    "jpg_quality": 0.9,
    "pixel_ratio": 2,
    "width_px": 2000
  },
  "rendered_bounds": [
    -129,
    41.25,
    -116.1,
    47.03
  ]
}