--- updatedAt: 2026-03-01T18:09:18.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/api-definitions/llms.txt --- # Get a category Returns a specific category that you can use to tag endpoints. # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's API Endpoint Definition API", "url": "https://techdocs.akamai.com/api-definitions/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Categories", "version": "v2" }, "openapi": "3.0.0", "paths": { "/categories/{apiCategoryId}": { "get": { "description": "Returns a specific category that you can use to tag endpoints.", "externalDocs": { "description": "See documentation for this operation in Akamai's API Endpoint Definition API", "url": "https://techdocs.akamai.com/api-definitions/reference/get-category" }, "operationId": "get-category", "parameters": [ { "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).", "in": "query", "name": "accountSwitchKey", "required": false, "schema": { "example": "1-5C0YLB:1-8BYUX", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "apiCategoryDescription": "The applications related to the Sales department.", "apiCategoryId": 9902, "apiCategoryName": "Sales", "createDate": "2019-06-17T12:40:14+0000", "link": "/api-definitions/v2/categories/9902", "lockVersion": 0, "updateDate": "2019-06-17T12:40:14+0000" }, "schema": { "additionalProperties": false, "description": "An endpoint category.", "properties": { "apiCategoryDescription": { "description": "The description of the category that you may use to tag related endpoints. If you specify `null` or an empty string in the request, the JSON response doesn't include this field.", "nullable": true, "type": "string" }, "apiCategoryId": { "description": "The unique identifier for the category.", "type": "integer" }, "apiCategoryName": { "description": "The unique-per-account name of the category. Any empty value reflects back as an `__UNCATEGORIZED__` keyword.", "type": "string" }, "createDate": { "description": "The ISO 8601 timestamp indicating when you created the category.", "format": "date-time", "type": "string" }, "createdBy": { "description": "The identifier for the user who created the category.", "type": "string" }, "link": { "description": "The location of the navigable resource within this API, for use by API clients.", "nullable": true, "type": "string" }, "lockVersion": { "description": "The identifier used for optimistic locking. See [Concurrency control](https://techdocs.akamai.com/api-definitions/reference/concurrency-control) for details.", "type": "integer" }, "updateDate": { "description": "The ISO 8601 timestamp indicating when you last modified the category.", "format": "date-time", "type": "string" }, "updatedBy": { "description": "The identifier for the user who last modified the category.", "type": "string" }, "usageCount": { "description": "The number of endpoints that share the category.", "type": "integer" } }, "required": [ "apiCategoryName" ], "type": "object", "x-akamai": { "file-path": "schemas/category-dto.yaml" } } } }, "description": "Response data shows the category." }, "403": { "content": { "application/problem+json": { "example": { "detail": "You have insufficient permissions to perform this action. Ensure that you have the correct permissions set in Identity and Access Management.", "instance": "2602aedd-38a9-41c3-a607-8a6ad8129e6b", "status": 403, "title": "Forbidden", "type": "/api-definitions/error-types/forbidden" }, "schema": { "additionalProperties": true, "description": "Contains debugging information for error responses.", "properties": { "detail": { "description": "The detailed error message.", "type": "string" }, "errors": { "description": "Nested error responses.", "items": { "description": "A further nested problem detail object.", "type": "object", "x-akamai": { "file-path": "schemas/http-problem-details-recurse.yaml" } }, "type": "array" }, "instance": { "description": "The non-referenceable URL for the error instance.", "type": "string" }, "status": { "description": "The HTTP status code.", "type": "integer" }, "title": { "description": "The title of the error.", "type": "string" }, "type": { "description": "The URL for the error type.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/http-problem-details.yaml" } } } }, "description": "[Forbidden](https://techdocs.akamai.com/api-definitions/reference/403). You don't have permission to get the API endpoint category.", "x-akamai": { "file-path": "errors/403.yaml" } }, "404": { "content": { "application/problem+json": { "example": { "detail": "Resource not found.", "instance": "d54686b5-21cb-4ab7-a8d6-a92282cf1749", "status": 404, "title": "Not Found", "type": "/api-definitions/error-types/not-found" }, "schema": { "additionalProperties": true, "description": "Contains debugging information for error responses.", "properties": { "detail": { "description": "The detailed error message.", "type": "string" }, "errors": { "description": "Nested error responses.", "items": { "description": "A further nested problem detail object.", "type": "object", "x-akamai": { "file-path": "schemas/http-problem-details-recurse.yaml" } }, "type": "array" }, "instance": { "description": "The non-referenceable URL for the error instance.", "type": "string" }, "status": { "description": "The HTTP status code.", "type": "integer" }, "title": { "description": "The title of the error.", "type": "string" }, "type": { "description": "The URL for the error type.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/http-problem-details.yaml" } } } }, "description": "[Not found](https://techdocs.akamai.com/api-definitions/reference/404). The API endpoint category doesn't exist.", "x-akamai": { "file-path": "errors/404.yaml" } } }, "summary": "Get a category", "tags": [ "Categories" ] }, "parameters": [ { "description": "The unique identifier for the category.", "in": "path", "name": "apiCategoryId", "required": true, "schema": { "example": 17365, "type": "integer" }, "x-akamai": { "file-path": "parameters/api-category-id-path.yaml" } } ], "x-akamai": { "file-path": "paths/api-category.yaml", "path-info": "/categories/{apiCategoryId}" } } }, "servers": [ { "url": "https://{hostname}/api-definitions/v2" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "02-category-resource.yaml" }, "x-readme": { "samples-languages": [ "curl", "python", "node" ], "explorer-enabled": true, "proxy-enabled": true } } ``` # Sibling pages * [Create a category](https://techdocs.akamai.com/api-definitions/reference/post-category.md) * [List categories](https://techdocs.akamai.com/api-definitions/reference/get-categories.md) * [Edit a category](https://techdocs.akamai.com/api-definitions/reference/put-category.md) * [Delete a category](https://techdocs.akamai.com/api-definitions/reference/delete-category.md)