{% extends "static_api/docs/layout.html" %}
{% import "static_api/docs/macros/common.html" as common with context %}
{% block description %}Gets persons (employees).{% endblock %}
{% block returns %}
A list of persons or one person.
{% endblock %}
{% block examples %}
{{ common.examples_start() }}
{{ common.example(resource, 'Full information about person', '?login=tyv&_one=1') }}
{{ common.example(resource, 'Phone numbers of the three employees', '?login=tyv,volozh,aleksundra&_fields=login,phones.number') }}
{{ common.example(resource, 'T-shirt sizes for employees from Moscow offices', '?location.office.city.name.en=Moscow&_fields=login,personal.tshirt_size') }}
{{ common.example(resource, 'In what departments the dismissed employees are, 1000 persons per page', '?_limit=1000&official.is_dismissed=true&_fields=login,department_group') }}
{{ common.examples_end() }}
{% endblock %}
{% block notes %}
{{ common.notes_start() }}
{{ common.note('Response includes dismissed employees.') }}
Please use this example for proper pagination:
Staff API Recipes
{{ common.notes_end() }}
{% endblock %}
{% block authorization %}
{% include "api/authorization.html" %}
{% endblock %}