# Tags API Reference

> Source: https://centric-api-docs.certn.co/#tags

Tags are used to categorize and filter Cases.

Tags must be created via the Client Portal.


## Endpoints

| Method | Path | Description |
|--------|------|-------------|
| `GET` | `/api/public/tags/` |  |
| `POST` | `/api/public/tags/create/` |  |

### GET /api/public/tags/

Returns a list of all available Tags.

Tags can be filtered by `name`, which allows you to look up the ID of a particular tag. This ID
can then be provided when ordering a new Case.

#### Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `id` | query | string | No |  |
| `is_active` | query | boolean | No |  |
| `name` | query | string | No |  |
| `page` | query | integer | No | A page number within the paginated result set. |
| `page_size` | query | integer | No | Number of results to return per page. Defaults to 10, maximum 100. |

#### Example Request

```bash
curl -X GET "https://api.sandbox.certn.co/api/public/tags/" \
  -H "Authorization: Api-Key YOUR_API_KEY"
```

### POST /api/public/tags/create/

Create a Tag.

Returns a Tag ID that can be used when ordering a Case.

#### Example Request

```bash
curl -X POST "https://api.sandbox.certn.co/api/public/tags/create/" \
  -H "Authorization: Api-Key YOUR_API_KEY"
```

---

*See the [interactive documentation](https://centric-api-docs.certn.co/#tags) for more details.*