Set your default language: PHP | Curl

GET categories

Returns a full list of place category names and ID's from our system. You may use either the category name or ID when adding a place via the POST /places endpoint. The list of categories is fairly static, and it's recommended this value be cached or stored with the application to avoid needing to call this endpoint repeatedly.


Requires Authentication No
Rate Limited Yes
Response Formats json


Parameter Required Notes
key The application ID for the application making the request.


There are no unique error states for this endpoint, please see our page detailing general errors you may encounter.

Example Usage

// Note: PHP Examples use the Heello PHP Client library
require_once dirname(dirname(dirname(__FILE__))) . '/Heello.php';

// You can get an Application Key and Secret by visiting:
$api_application_key = "APPLICATION_KEY";
$api_application_secret = "APPLICATION_SECRET";

$api = new Heello\Client($api_application_key, $api_application_secret);

  // Show the category information
  $categories = $api->categories->get();

} catch (Exception $e){
  print $e->getMessage();
Please use the "Live Demo" below to see an example response.
You may need to login or create an account before making requests against the API.

Live Demo

Please login and create an application to perform live API testing.