{% 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 %}