# Get users by attribute from server

Gets a list of users by an attribute. Returns a list of the users’ IDs, their emails, and the attributes that were specified in the ‘key’ object of the request.NoticeRate limits for server-side methods are applied to this method.

Endpoint: POST /attributes/users/get
Version: v1
Security: AttributesServer

## Request fields (application/json):

  - `after` (string,null)
    Update date of user’s attribute and ID of the latest attribute in the keys list. Do not set it at the first time.
When you get users by attribute, they are sorted by their update date. If several attributes have the same update date, they are sorted by attribute ID.
It is used for API pagination.

  - `attr_type` (string)
    Definition of user’s access level to service attributes.
    Enum: "client", "server"

  - `attribute` (object, required)
    Attribute is used to get users’ list.

  - `attribute.key` (string, required)
    Name of attribute that is used to identify user’s attribute. Must be unique per user.

  - `attribute.value` (string,null)
    Value of user’s attribute. Needed for getting users with the key parameter with this value. If you do not specify it, it returns all users with any value for this key.

  - `keys` (array)
    List of attributes’ keys which you want to get. If you do not specify them, the method returns all user’s attributes.

  - `limit` (integer)
    Number of users that is returned when searching by attribute.

  - `login_project_id` (string)
    Login ID from Publisher Account which you want to get user’s attributes for. If you do specify it, it is use instead your merchant ID and project ID from Publisher Account.

  - `publisher_id` (integer,null)
    Your merchant ID the request is made for. Needed for request authorizing.

  - `publisher_project_id` (integer)
    Project ID from Publisher Account which you want to get users for. If you do not specify it, it returns users without the value of this parameter.

  - `search_type` (string)
    Сomparison condition that defines search criteria.
    Enum: "equal", "like"

## Response 200 fields (application/json):

  - `attributes` (array)
    List of attributes of the specified user.

  - `attributes.attr_type` (string)
    Definition of user’s access level to service attributes.
    Enum: "client", "server"

  - `attributes.data_type` (string,null)
    Data type of attribute
    Enum: "string", "number", "integer", "boolean"

  - `attributes.description` (string,null)
    Description of attribute from JSON Schema.

  - `attributes.format` (string,null)
    Format of attribute from JSON Schema. Can be date-time, date, time, duration, email, uri, uuid or other from JSON Schema [specification](https://json-schema.org/draft/2020-12/json-schema-validation.html#rfc.section.7.3)

  - `attributes.key` (string, required)
    Name of attribute that is used to identify user’s attribute.

  - `attributes.permission` (string,null)
    Definition of user’s access level to other users’ attributes.
    Enum: "public", "private"

  - `attributes.readonly` (boolean, required)
    The attribute is read-only

  - `attributes.value` (string, required)
    Value of user’s attribute.

  - `email` (string)
    User's email.

  - `user_id` (string)
    User ID. You can find it in Publisher Account > Login settings > Users > Username/ID.

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.code` (string, required)
    Error code.
    Example: "003-061"

  - `error.description` (string, required)
    Error description.
    Example: "Object not found."

  - `error.details` (object)
    Additional information.

## Response 403 fields (application/json):

  - `error_code` (string)
    Error code.

  - `error_description` (string)
    Error description.

## Response 422 fields (application/json):

  - `error_code` (string)
    Error code.

  - `error_description` (string)
    Error description.

## Response 429 fields (application/json):

  - `error_code` (string)
    Error code.

  - `error_description` (string)
    Error description.