> For the complete documentation index, see [llms.txt](https://docs.guardianservice.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.guardianservice.app/technical-information/users/standard-registry-users-schemas-and-policies/policies/creating-a-policy-using-apis/retrieves-block-data-by-tag.md).

# Retrieves Block Data by Tag

### RETRIEVES BLOCK DATA BY TAG

## Requests block data

<mark style="color:blue;">`GET`</mark> `/policies/{policyId}/tag/{tag}/blocks`

Requests block data by tag. Only users with a role that described in block are allowed to make the request.

#### Path Parameters

| Name                                       | Type   | Description                  |
| ------------------------------------------ | ------ | ---------------------------- |
| policyId<mark style="color:red;">\*</mark> | String | Selected Policy ID           |
| tag<mark style="color:red;">\*</mark>      | String | Tag from the selected policy |

{% tabs %}
{% tab title="200: OK Successful Operation" %}

```javascript
{
    application/json:
              schema:
                $ref: '#/components/schemas/PolicyBlockData'
}
```

{% endtab %}

{% tab title="401: Unauthorized Unauthorized" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="403: Forbidden Forbidden" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="500: Internal Server Error Internal Server Error" %}

```javascript
{
     application/json:
              schema:
                $ref: '#/components/schemas/Error'
}
```

{% endtab %}
{% endtabs %}