---
name: "hr_get_person"
area: "hr"
title: "Get a person"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/hr_get_person"
mcp_server: "https://api.conecto.chat/mcp/hr"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/hr/hr_get_person"
---

# Get a person (`hr_get_person`)

Everything about one person: details, leave balances for a year, pending and upcoming leave, documents, open tasks and direct reports.

Everything about one person: their details, their time-off balance of each leave type for a leave year (entitlement, carried over, adjustments, approved, pending, available after pending), the adjustments in it, their pending requests and approved leave from today on, documents with download links, open checklist tasks and direct reports.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

Someone asks about one person: their days left, their contract, their tasks.

## Say this to your agent

> How many vacation days does Tom have left this year?

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `person` | integer or string | yes | The person_id, or their work email. 1 to 254 characters, at least 1. |  |  |
| `year` | integer | no | A leave year, named by the year it starts in. Default: the current one. 2,000 to 2,100. |  |  |

## Example

Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff.

MCP: call `hr_get_person` on the MCP server `https://api.conecto.chat/mcp/hr` with these arguments:

```json
{
  "person": "tom.okafor@hansenvoss.example"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/hr_get_person \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person": "tom.okafor@hansenvoss.example"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "hr_get_person",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "person": {
      "person_id": 4102,
      "name": "Tom Okafor",
      "first_name": "Tom",
      "last_name": "Okafor",
      "preferred_name": null,
      "work_email": "tom.okafor@hansenvoss.example",
      "job_title": "Support Lead",
      "department": "Support",
      "location": "Hamburg",
      "manager": {
        "person_id": 4101,
        "name": "Lena Brandt"
      },
      "employment_type": "full_time",
      "start_date": "2024-05-15",
      "probation_end": null,
      "end_date": null,
      "status": "active",
      "personal_email": null,
      "phone": null,
      "birthday": null,
      "emergency_contact": null,
      "notes": null,
      "custom": {},
      "allowances": {},
      "created_at": "2026-10-14T08:00:00+00:00",
      "updated_at": "2026-10-14T08:00:00+00:00"
    },
    "leave_year": {
      "year": 2026,
      "from": "2026-01-01",
      "to": "2026-12-31"
    },
    "hours_per_day": "8",
    "balances": [
      {
        "leave_type": "Sick",
        "tracked": false,
        "paid": true,
        "year": 2026,
        "approved": "0",
        "pending": "0"
      },
      {
        "leave_type": "Vacation",
        "tracked": true,
        "paid": true,
        "year": 2026,
        "from": "2026-01-01",
        "to": "2026-12-31",
        "annual_days": "28",
        "own_allowance": false,
        "accrual": "yearly",
        "months_counted": 12,
        "entitlement": "28",
        "carried_over": "0",
        "adjustments": "0",
        "approved": "0",
        "balance": "28",
        "pending": "7.5",
        "available_after_pending": "20.5"
      }
    ],
    "adjustments": [],
    "leave": [
      {
        "request_id": 4101,
        "person": {
          "person_id": 4102,
          "name": "Tom Okafor"
        },
        "leave_type": "Vacation",
        "paid": true,
        "start": "2026-12-21",
        "end": "2026-12-31",
        "half_start": false,
        "half_end": true,
        "days": "7.5",
        "hours": "60",
        "by_leave_year": {
          "2026": "7.5"
        },
        "status": "pending",
        "note": "Christmas with family",
        "decision_note": null,
        "decided_by": null,
        "decided_at": null,
        "allow_negative": false,
        "created_at": "2026-10-14T08:00:00+00:00"
      }
    ],
    "documents": [],
    "open_tasks": [],
    "direct_reports": []
  }
}
```

`result`: The person's details, the leave year and hours per day, the balance of each leave type (entitlement, carried over, adjustments, approved, pending, available), the adjustments, pending and upcoming leave, documents with download links, open tasks and direct reports.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_found` | 404 | No person of the business has that person_id or work email. | Find them with hr_list_people. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [hr_save_people](https://conecto.chat/tools/hr/hr_save_people.md): Adds people or changes them, up to 100 at a time, all or none: names, emails, job, department, location, manager, dates and allowances. $1.00 per person added.
- [hr_list_people](https://conecto.chat/tools/hr/hr_list_people.md): People by last name, everyone who hasn't left by default, filtered by status, department, location, manager, type or words. Free up to 1,000,000 reads a month.
- [hr_delete_person](https://conecto.chat/tools/hr/hr_delete_person.md): Erases a person for good with their leave, tasks and document records; their files stay in the store. Free.
- [hr_get_settings](https://conecto.chat/tools/hr/hr_get_settings.md): The working days, hours, leave year, time zone, leave types, public holidays and checklists. Free up to 1,000,000 reads a month.
- [hr_save_settings](https://conecto.chat/tools/hr/hr_save_settings.md): Sets the work calendar: working days, hours per day, leave year, time zone, and one location's public holidays for a year. $0.001 a call.
- [hr_save_leave_type](https://conecto.chat/tools/hr/hr_save_leave_type.md): Adds or changes a kind of time off: annual days, monthly or yearly accrual, carry-over, paid and tracked. $0.001 a call.
- [hr_adjust_leave](https://conecto.chat/tools/hr/hr_adjust_leave.md): Adds days to, or takes days off, one person's balance of a tracked leave type, with the reason. $0.01 a call.
- [hr_request_leave](https://conecto.chat/tools/hr/hr_request_leave.md): Asks for time off for someone, counting working days less holidays; it waits for a decision unless approved at once. $0.01 a call.
- [hr_decide_leave](https://conecto.chat/tools/hr/hr_decide_leave.md): Approves or declines a pending leave request, or cancels one that is pending or approved. $0.01 a call.
- [hr_list_leave](https://conecto.chat/tools/hr/hr_list_leave.md): Leave requests, latest start first, by person, status, type or dates. Free up to 1,000,000 reads a month.
- [hr_who_is_out](https://conecto.chat/tools/hr/hr_who_is_out.md): Who is off in a period (today by default), with each leave and its days, plus public holidays and people on long leave. Free up to 1,000,000 reads a month.
- [hr_save_checklist](https://conecto.chat/tools/hr/hr_save_checklist.md): Adds or changes an onboarding or offboarding checklist: items with an owner and a due day relative to the start or last day. $0.001 a call.
- [hr_start_checklist](https://conecto.chat/tools/hr/hr_start_checklist.md): Turns a checklist into tasks for one person, each due relative to their start date or last day. $0.01 a call.
- [hr_tasks](https://conecto.chat/tools/hr/hr_tasks.md): Checklist tasks, soonest due first: open, overdue, done or all, for one person, one owner or a date. Free up to 1,000,000 reads a month.
- [hr_complete_task](https://conecto.chat/tools/hr/hr_complete_task.md): Marks a checklist task done, or opens it again. $0.01 a call.
- [hr_save_document](https://conecto.chat/tools/hr/hr_save_document.md): Keeps a file from the store on a person's record (a contract, an ID, a certificate), or changes or removes it. $0.01 a call.
- [hr_report](https://conecto.chat/tools/hr/hr_report.md): Headcount, joiners and leavers, time off taken, or everyone's leave balances. Free up to 1,000,000 reads a month.
- [hr_dashboard_link](https://conecto.chat/tools/hr/hr_dashboard_link.md): A one-time link to HR at a glance: who is out, leave to decide, open tasks, and who starts or leaves soon. Free up to 1,000,000 reads a month.
- [hr_save_policy](https://conecto.chat/tools/hr/hr_save_policy.md): Keeps a policy people must read and confirm, like an AI use policy; a changed text is a new version. $0.001 a call.
- [hr_send_policy](https://conecto.chat/tools/hr/hr_send_policy.md): Emails each person in a policy's scope a one-time link to read and confirm its current version. $0.02 per email sent.
- [hr_record_training](https://conecto.chat/tools/hr/hr_record_training.md): Records a training someone completed, like AI literacy, with its date, hours, certificate and expiry. $0.01 a call.
- [hr_policy_status](https://conecto.chat/tools/hr/hr_policy_status.md): Who confirmed each policy's current version, and who holds a valid training of each kind. Free up to 1,000,000 reads a month.