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. |