# CategoryFind

Allows you to return the IDs of all categories with a specified name. The name matching is case insensitive.

NOTE: This is an administrative action that can be sent only by users that belong to an authorization role that allows the `Admin` standard role, or which enables the action explicitly. See Authorization Roles Configuration Parameters.

## Example

    http://12.3.4.56:9000/action=CategoryFind&Name=Botanics

This action returns the IDs of all categories that have the name `Botanics`.

    http://12.3.4.56:9000/action=CategoryFind&TaxonomyName=Medicines&Name=Botanics

This action returns the IDs of all categories in the `Medicines` taxonomy that have the name `Botanics`.

## Required Parameters

The following action parameters are required.

Parameter | Description
--- | ---
Name | The name of the category to find.

## Optional Parameters

This action accepts the following optional parameters.

Parameter | Description
--- | ---
Parent | The ID of the parent of the category to find.
Schema | The ID of a category that exists above the category that you want to find in the category hierarchy.
TaxonomyName | The name of a taxonomy that the category to find belongs to.
UserName | The name of the user that sends the action.

This action accepts the following standard ACI action parameters.

Parameter | Description
--- | ---
ActionID | A string to use to identify an ACI action.
EncryptResponse | Encrypt the output.
FileName | The file to write output to.
ForceTemplateRefresh | Forces the server to load the template from disk.
Output | Writes output to a file.
ResponseFormat | The format of the action output.
Template | The template to use for the action output.
TemplateParamCSVs | A list of variables to use for the specified template.

_FT_HTML5_bannerTitle.htm