> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/users/{ownerId}/people/avoid)

> GET (/users/{ownerId}/people/avoid)

# GET (/users/{ownerId}/people/avoid)

Gets the Avoid list for a user.

* [Remarks](#ID4EQ)
* [URI parameters](#ID4EZ)
* [Authorization](#ID4EEB)
* [Required Request Headers](#ID4EJC)
* [HTTP status codes](#ID4EYD)
* [Required Response Headers](#ID4E1F)
* [Response body](#ID4ESH)

<a id="ID4EQ" />

## Remarks

If a target is given, only returns that user if they're on the block list, or else empty if they're not.

<a id="ID4EZ" />

## URI parameters

| Parameter | Type   | Description                                                                                                                                                                                                                   |
| --------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ownerId   | string | Required. Identifier of the user whose resource is being accessed. The possible values are <code>xuid({xuid})</code>. Must be the authenticated user. Example value: <code>xuid(2603643534573581)</code>. Maximum size: none. |

<a id="ID4EEB" />

## Authorization

Authorization claims used | Claim| Type| Required?| Example value|
\| --- | --- | --- | --- | --- | --- | --- |
\| Xuid| 64-bit signed integer| yes| 1234567890|

<a id="ID4EJC" />

## Required Request Headers

\| Header| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization | string| Authentication credentials for HTTP authentication. Example value: <code>Xauth=\<authtoken></code>. Maximum size: none.|
\| Accept| string| Content-Types that are acceptable. Example value: <code>application/json</code>. Maximum size: none.|

<a id="ID4EYD" />

## HTTP status codes

The service returns one of the status codes in this section in response to a request made with this method on this resource. For a complete list of standard HTTP status codes used with XBOX Live Services, see [Standard HTTP status codes](/reference/live/rest/additional/httpstatuscodes).

\| Code| Reason phrase| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| The session was successfully retrieved.|
\| 400| Bad Request| The target ID specified in the URI is not valid.|
\| 403| Forbidden| The owner specified in the URI is not the authenticated user.|
\| 404| Not Found| The owner specified in the URI does not exist.|

<a id="ID4E1F" />

## Required Response Headers

\| Header| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Type| string| The MIME type of the body of the request. Example value: <code>application/json</code>. Maximum size: none.|
\| Content-Length| string| The number of bytes being sent in the response. Example value: 34. Maximum size: none.|
\| Cache-Control| string| Polite request from the server to specify caching behavior. Example value: <code>application/json</code>. Maximum size: none.|

<a id="ID4ESH" />

## Response body

<a id="ID4EYH" />

### Sample response

```cpp theme={null}
{
    "users":
    [
        { "xuid":"12345" },
        { "xuid":"23456" }
    ]
}

```

<a id="ID4EDAAC" />

## See also

<a id="ID4EFAAC" />

##### Parent

[/users/{ownerId}/people/avoid](/reference/live/rest/uri/privacy/uri-privacyusersxuidpeopleavoid)


## Related topics

- [Privacy and permissions overview](/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [Información general sobre privacidad y permisos](/es/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [개인정보 및 권한 개요](/ko/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [隐私和权限概述](/zh-CN/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [Displaying people from the People System](/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)