---
title: "Tags API"
description: "This guide will teach you how to use the Tags API, which you'll use to retrieve all the tags from your repository."
meta_title: "Tags API Technical Reference"
audience: developers
lastUpdated: "2025-11-06T01:07:50.000Z"
---

> **Important**
>
> <CalloutHeading>📦  Beta Access</CalloutHeading>
>
> The tags API is currently in the **beta** stage of its development cycle. If you can't access the endpoint, you can request access via the [Prismic community forum](https://community.prismic.io/t/feature-activations-graphql-integration-fields-etc/847).

# What is it?

Prismic has a native [page tagging system](https://prismic.io/docs/guides/organize-content.md#tags) to help you organize your pages. The Tags API is a tool that allows you to hit an endpoint to retrieve all the tags of your repository.

# Tags API endpoint

The tags API endpoint allows you to return all the repository's tags in an array. Here is an example URL of a tags API endpoint:

```bash
https://your-repo-name.cdn.prismic.io/api/tags
```

When you hit the `/api/tags` endpoint, you will get an array with all the existing tags of the repository. Any tags added to published pages and pages in releases will appear in the array. Here's a body response example:

```bash
["blue", "yellow", "red"]
```

Any tags added to drafts and pages in releases will also apear in the response.

If the repository is brand new and without any tags, we return a 404. Otherwise, it will be an empty array `[]`.