200 List of map records

object

items

• array of objects

items

• object

name

• string

description

• string

permission

• string
• enum
  • viewer
  • editor

latestState

• file

Currently, cannot be uploaded from the API explorer. Coming soon.

datasets

• array of objects

datasets

• object

id

• string

name

• string

type

• string
• enum
  • managed
  • externally-hosted
  • sample
  • vector-tile
  • raster-tile
  • hex-tile

description

• string

privacy

• string
• enum
  • private
  • public_read

permission

• string
• enum
  • viewer
  • editor

isValid

• boolean

createdAt

• date-time

updatedAt

• date-time

metadata

• object

metadata object

id

• string

createdAt

• date-time

updatedAt

• date-time

Shell Example

curl --request GET \
     --url https://data-api.foursquare.com/v1/maps/for-organization \
     --header 'accept: application/json'

JSON Response Example

{
  "items": [
    {
      "name": "string",
      "description": "string",
      "permission": "viewer",
      "latestState": "string",
      "datasets": [
        {
          "id": "string",
          "name": "string",
          "type": "managed",
          "description": "string",
          "privacy": "private",
          "permission": "viewer",
          "isValid": true,
          "createdAt": "2026-07-25T03:52:18.059Z",
          "updatedAt": "2026-07-25T03:52:18.059Z",
          "metadata": {
            "contentType": "string",
            "size": 0
          }
        }
      ],
      "id": "string",
      "createdAt": "2026-07-25T03:52:18.059Z",
      "updatedAt": "2026-07-25T03:52:18.059Z"
    }
  ]
}