Upload Dataset

Dataset Schema

Following is the schema for the dataset required:

• name: string (required)
  Name of the dataset.
• description: string
  Description of the dataset.
• The raw data to upload.

Response

• 200
  Successful upload.

Response Object

• name: string
• description: string
• id: string
• type: string
  • enum: managed, externally-hosted, sample, vector-tile, raster-tile, hex-tile
• privacy: string
  • enum: private, public_read
• permission: string
  • enum: viewer, editor
• isValid: boolean
• createdAt: date-time
• updatedAt: date-time
• metadata: object
  • contentType: string
  • size: number

Example cURL Request

curl --request POST \
     --url https://data-api.foursquare.com/v1/datasets/data \
     --header 'accept: application/json' \
     --header 'content-type: application/json'

Example JSON Response

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