---
title: "Get restriction query for a given role"
method: GET
path: "/api/v2/logs/config/restriction_queries/role/{role_id}"
tags: ["Logs Restriction Queries"]
---

# Get restriction query for a given role

`GET /api/v2/logs/config/restriction_queries/role/{role_id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/logs/config/restriction_queries/role/{role_id}`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Get restriction query for a given role.

## Path parameters

- `role_id` string, required

## Response `200`

OK

- RestrictionQueryListResponse: Response containing information about multiple restriction queries.
  - `data` RestrictionQueryWithoutRelationships[]: Array of returned restriction queries.
    - `attributes` RestrictionQueryAttributes: Attributes of the restriction query.
      - `created_at` string, date-time: Creation time of the restriction query.
      - `last_modifier_email` string: Email of the user who last modified this restriction query.
      - `last_modifier_name` string: Name of the user who last modified this restriction query.
      - `modified_at` string, date-time: Time of last restriction query modification.
      - `restriction_query` string: The query that defines the restriction. Only the content matching the query can be returned.
      - `role_count` integer: Number of roles associated with this restriction query.
      - `user_count` integer: Number of users associated with this restriction query.
    - `id` string: ID of the restriction query.
    - `type` string: Restriction queries type.

## Other responses

- `400`: Bad Request
- `403`: Authentication error
- `404`: Not found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)