Get the category details for a category ID.
The /categories/{category request returns all the groups to which the category belongs. You must supply a category ID to use this request.
Note: Query parameters are case-sensitive.
Query parameters
| Name | Type | Required | Default value | Description |
|---|---|---|---|---|
| | The requested response format - either | ||
| | The authentication token with the |
f
The requested response format - either json or pjson (pretty json).
- Default
- json
Enumerated values
token
The authentication token with the premium: privilege, used to access the Places service.
The token parameter can be either an API Key or short-lived token. See
ArcGIS security
documentation
for more information on authenticating with a token or API key.
Alternatively, you can supply a token in the request header with one of the following keys using the "Bearer" scheme:
Authorization:Bearer < YOUR_ TOKEN> X-Esri-Authorization:Bearer < YOUR_ TOKEN>
Path parameters
| Name | Type | Required | Default value | Description |
|---|---|---|---|---|
| The ID of the category that you want to fetch details for. |
categoryId
The ID of the category that you want to fetch details for.
For example, using a category ID of 13035 would fetch details about
the "Coffee Shop" category.
Examples
Request
# You can also use wget
curl -X GET https://places-api.arcgis.com/arcgis/rest/services/places-service/v1/categories/{categoryId} \
-H 'Accept: application/json'Response
200 Response
{
"categoryId": "17119",
"fullLabel": [
[
"Retail",
"Sporting Goods Retail",
"Bicycle Store"
]
],
"parents": [
[
"17117"
]
]
}| Status | Meaning | Description | Schema |
|---|---|---|---|
| A successful request to return details for a single category. | ||
| Invalid query parameters. | ||
| Authentication Error. The API key or token is missing, invalid or expired. | ||
| The required parameter 'token' is valid but does not have permission to access the service. | ||
| A resource with the supplied Id was not found. | ||
| Unknown | An error occurred on the server. |