Get Venue Categories

Public Beta Feature

This documentation covers a feature currently in Public Beta. Access is available to anyone interested in building personalized experiences for their end-users.

This feature is subject to the Personalization API (Self-Service) Public Beta End User License Agreement.

API Version

string

required
The API version date as documented here; e.g. 20231010

accept

string
enum
Defaults to application/json

Generated from available response content types:
application/json, text/plain
Allowed:
application/json, text/plain

Example Response - 200

{
  "meta": {
    "code": 200,
    "requestId": "5854a3664434b94a0959cfb7"
  },
  "notifications": [
    {
      "item": {
        "unreadCount": 13
      },
      "type": "notificationTray"
    }
  ],
  "response": {
    "categories": [
      {
        "id": "4d4b7104d754a06370d81259",
        "name": "Arts and Entertainment",
        "pluralName": "Arts and Entertainment",
        "shortName": "Arts & Entertainment",
        "icon": {
          "prefix": "https://ss3.4sqi.net/img/categories_v2/arts_entertainment/default_",
          "suffix": ".png"
        },
        "categoryCode": 10000,
        "categories": [
          {
            "id": "4bf58dd8d48988d182941735",
            "name": "Amusement Park",
            "pluralName": "Amusement Parks",
            "shortName": "Amusement Park",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/arts_entertainment/themepark_",
              "suffix": ".png"
            },
            "categoryCode": 10001,
            "categories": [
              {
                "id": "5109983191d435c0d71c2bb1",
                "name": "Attraction",
                "pluralName": "Attractions",
                "shortName": "Attraction",
                "icon": {
                  "prefix": "https://ss3.4sqi.net/img/categories_v2/arts_entertainment/themepark_",
                  "suffix": ".png"
                },
                "categoryCode": 10058,
                "categories": []
              }
            ]
          },
          {
            "id": "4fceea171983d5d06c3e9823",
            "name": "Aquarium",
            "pluralName": "Aquariums",
            "shortName": "Aquarium",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/arts_entertainment/aquarium_",
              "suffix": ".png"
            },
            "categoryCode": 10002,
            "categories": []
          },
          {
            "id": "4bf58dd8d48988d1e1931735",
            "name": "Arcade",
            "pluralName": "Arcades",
            "shortName": "Arcade",
            "icon": {
              "prefix": "https://ss3.4sqi.net/img/categories_v2/arts_entertainment/arcade_",
              "suffix": ".png"
            },
            "categoryCode": 10003,
            "categories": []
          }
        ]
      }
    ]
  }
}

Example Request

curl --request GET \
     --url https://api.foursquare.com/v2/venues/categories \
     --header 'accept: application/json'