API update: more map details, paging, and a changes-only list
The Enfumap API has grown. Five small changes, all of them additions: nothing that worked before has changed, so existing code keeps working exactly as it did.
These came from requests by people already building on the API. Thank you, keep them coming.
What's new
1. Workshop ID and version of the addon
Every community map now says which addon it is built from (workshop) and which version of that addon the tiles were built from (modVersion). Bohemia's own maps have no Workshop addon, so both are null for them.
2. The world file's GUID
worldGuid is the resource GUID of the world file (.ent) the map was exported from. All maps have it.
3. World size as X and Z
worldSizeX and worldSizeZ give each side of the world in metres, because a world isn't guaranteed to be square. Every map is square today, so the two match, but your code no longer has to assume it. worldSize is still there and equals worldSizeX.
4. Paging through places
A request still returns at most 500 places, but you can now read on with offset:
/api/v1/maps/everon/places?limit=500&offset=0
/api/v1/maps/everon/places?limit=500&offset=500
The total number of matching places comes back in an X-Total-Count header (readable from a browser too). The order never changes between requests, so pages never overlap or skip a place. It works with search and the kind filter as well.
5. Only what changed
Every map has an updatedAt (unix seconds): the last time it changed on Enfumap, whether that was a new build, a satellite layer or a hand drawn layer. Add updatedSince to the map list to get only the maps changed after a moment:
/api/v1/maps?updatedSince=1793000000
/api/v1/maps?updatedSince=2026-11-01
Handy for a once-a-day sync that only fetches the difference. It takes unix seconds, a date, or a full ISO time. Two things to know: a map that is taken off the site just stops being listed, so now and then compare the full list's slugs with your own to catch removals, and an unreadable value gets a clear bad_updatedSince error (400).
Try it
curl "https://enfumap.com/api/v1/maps?updatedSince=2026-11-01"
Also new: the docs page
The API documentation has been rebuilt. It now lists every field in a "Map details" table, has a short guide to keeping a copy in sync, and works properly on a phone, with a contents bar that follows you down the page. Every endpoint still has a Try it button that calls the live API.
Building something with it? Credit Enfumap wherever you show a map, and for community maps their author too. If you need something the API doesn't do yet, ask.
