Monthly PTO

Every PTO value is in hours. A monthly PTO record tracks, for one user in one month, the hours expected, the hours worked, the PTO earned and used, the balance carried from the previous month, and any resulting salary deduction. For fields and response details, see the API reference for listing monthly PTO and updating PTO earned.

List monthly PTO

Read the report for a month. Omit --user-email for the whole organization.

neetoinvoice monthly-ptos list --month 7 --year 2026

Flag	Type	Required	Default	Description
`--month`	`int`	Yes	`0`	Month number (1-12)
`--user-email`	`string`	No		Filter to a single user by email
`--year`	`int`	Yes	`0`	Year, e.g. 2026

Sample output (--json)

{
  "data": {
    "month": 7,
    "year": 2026,
    "monthly_ptos": [
      {
        "user_email": "oliver@example.com",
        "user_name": "Oliver Smith",
        "expected_hours": 176.0,
        "hours_worked": 168.0,
        "pto_earned": 8.0,
        "pto_used": 8.0,
        "previous_month_pto": 4.0,
        "net_pto": 4.0,
        "salary_deduction": 0.0,
        "locked": false
      }
    ]
  }
}

Update PTO earned

Set PTO earned for one or more users in a month. --email is repeatable. Pass --pto-earned 0, or omit the flag, to clear earned PTO.

neetoinvoice monthly-ptos update-earned \
  --month 7 \
  --year 2026 \
  --email oliver@example.com \
  --email sam@example.com \
  --pto-earned 8

Flag	Type	Required	Default	Description
`--email`	`stringSlice`	Yes	`[]`	User email (repeatable)
`--month`	`int`	Yes	`0`	Month number (1-12)
`--pto-earned`	`float64`	No	`0`	New PTO earned in hours (default: 0)
`--year`	`int`	Yes	`0`	Year, e.g. 2026

The response reports each email separately, so a bad address in the list does not fail the whole run.

Sample output (--json)

{
  "data": {
    "month": 7,
    "year": 2026,
    "updated": [
      { "user_email": "oliver@example.com", "pto_earned": 8.0, "net_pto": 4.0 }
    ],
    "skipped": [{ "user_email": "sam@example.com", "reason": "User not found" }]
  }
}

Reading the report and changing it are separate permissions. An account that can view monthly PTO may still be refused update-earned.

Getting started

Commands

List monthly PTO

Update PTO earned

​List monthly PTO

​Update PTO earned

List monthly PTO

Update PTO earned