# Tags

Use tags to organize and categorize customers or KYC documents based on keywords.

## Retrieve tags

 - [GET /tags](https://www.rebilly.com/docs/dev-docs/api/tags/gettagcollection.md): Retrieves a list of tags.

## Create a tag

 - [POST /tags](https://www.rebilly.com/docs/dev-docs/api/tags/posttag.md): Creates a tag.

## Retrieve a tag

 - [GET /tags/{tag}](https://www.rebilly.com/docs/dev-docs/api/tags/gettag.md): Retrieves a tag with a specified name.

## Update a tag

 - [PATCH /tags/{tag}](https://www.rebilly.com/docs/dev-docs/api/tags/patchtag.md): Updates a tag with a specified name.

## Delete a tag

 - [DELETE /tags/{tag}](https://www.rebilly.com/docs/dev-docs/api/tags/deletetag.md): Deletes a tag with a specified name.
This is an asynchronous operation.

## Tag a list of customers

 - [POST /tags/{tag}/customers](https://www.rebilly.com/docs/dev-docs/api/tags/posttagcustomercollection.md): Tags a list of customers.

If a customer in the list already has the specified tag applied, the customer is ignored.
This is an asynchronous operation.

## Untag a list of customers

 - [DELETE /tags/{tag}/customers](https://www.rebilly.com/docs/dev-docs/api/tags/deletetagcustomercollection.md): Untag a list of customers.

If a customer in the list does not have the specified tag applied, the customer is ignored.
This is an asynchronous operation.

## Tag a customer

 - [POST /tags/{tag}/customers/{customerId}](https://www.rebilly.com/docs/dev-docs/api/tags/posttagcustomer.md): Tags a customer.

## Untag a customer

 - [DELETE /tags/{tag}/customers/{customerId}](https://www.rebilly.com/docs/dev-docs/api/tags/deletetagcustomer.md): Untags a customer.

## Tag a list of KYC documents

 - [POST /tags/{tag}/kyc-documents](https://www.rebilly.com/docs/dev-docs/api/tags/posttagkycdocumentcollection.md): Tags a list of KYC documents.

If a KYC document in the list already has the specified tag applied, the KYC document is ignored.
This is an asynchronous operation.

## Untag a list of KYC documents

 - [DELETE /tags/{tag}/kyc-documents](https://www.rebilly.com/docs/dev-docs/api/tags/deletetagkycdocumentcollection.md): Untags a list of KYC documents.

If a KYC document in the list does not have the specified tag applied, the KYC document is ignored.
This is an asynchronous operation.

## Tag a KYC document

 - [POST /tags/{tag}/kyc-documents/{kycDocumentId}](https://www.rebilly.com/docs/dev-docs/api/tags/posttagkycdocument.md): Tags a KYC document.

## Untag a KYC document

 - [DELETE /tags/{tag}/kyc-documents/{kycDocumentId}](https://www.rebilly.com/docs/dev-docs/api/tags/deletetagkycdocument.md): Untags a KYC document.

## Tag a list of AML checks

 - [POST /tags/{tag}/aml-checks](https://www.rebilly.com/docs/dev-docs/api/tags/posttagamlcheckcollection.md): Tags a list of AML checks.

If an AML check in the list already has the specified tag applied, the AML check is ignored.
This is an asynchronous operation.

## Untag a list of AML checks

 - [DELETE /tags/{tag}/aml-checks](https://www.rebilly.com/docs/dev-docs/api/tags/deletetagamlcheckcollection.md): Untags a list of AML checks.

If an AML check in the list does not have the specified tag applied, the AML check is ignored.
This is an asynchronous operation.

## Tag an AML check

 - [POST /tags/{tag}/aml-checks/{amlCheckId}](https://www.rebilly.com/docs/dev-docs/api/tags/posttagamlcheck.md): Tags an AML check.

If an AML check in the list does not have the specified tag applied, the AML check is ignored.

## Untag an AML check

 - [DELETE /tags/{tag}/aml-checks/{amlCheckId}](https://www.rebilly.com/docs/dev-docs/api/tags/deletetagamlcheck.md): Untags an AML check.

If an AML check in the list does not have the specified tag applied, the AML check is ignored.

## Retrieve tags rules list

 - [GET /tags-rules](https://www.rebilly.com/docs/dev-docs/api/tags/gettagrulecollection.md): Retrieves a list of tags rules.

## Create tags rule

 - [POST /tags-rules](https://www.rebilly.com/docs/dev-docs/api/tags/posttagrule.md): Creates a tags rule.

## Retrieve a tags rule

 - [GET /tags-rules/{id}](https://www.rebilly.com/docs/dev-docs/api/tags/gettagrule.md): Retrieves a tags rule with a specified ID.

## Create a tags rule with specified ID

 - [PUT /tags-rules/{id}](https://www.rebilly.com/docs/dev-docs/api/tags/puttagrule.md): Creates a tags rule with a specified ID.

## Delete tags rule

 - [DELETE /tags-rules/{id}](https://www.rebilly.com/docs/dev-docs/api/tags/deletetagrule.md): Deletes a tags rule with a specified ID.