Get Account By ID

GET /accounts/{userId}

Returns a single user's account balances.

Accepts timeBalanceAsOf and vacationBalanceAsOf (no page / pageSize / includeInactive). An explicitly requested userId is returned regardless of active status. As in the list, vacationBalanceAsOf drives both the vacation balance and entitlement (same day, capped at the leaving date).

Authentication: header API_KEY: <userApiKey>.

Request example

REQUEST cURL EXAMPLE

https://mctime.com/api/v2/auth/accounts/00000000-0000-0000-0000-000000000001
//A single user (returned regardless of active status), balance & entitlement as of today.

https://mctime.com/api/v2/auth/accounts/00000000-0000-0000-0000-000000000001?vacationBalanceAsOf=1773532800000&timeBalanceAsOf=1772323200000
//Same user with explicit cut-offs (epoch ms).

Response — data is a single user object with the same fields as a list item:

RESPONSE JSON EXAMPLE

{
  "items": [
    {
      "message": "success",
      "data": {
        "userId": "00000000-0000-0000-0000-000000000001",
        "userFirstName": "John",
        "userLastName": "Doe",
        "timeBalanceHours": 40.0,
        "timeBalanceAsOf": "2026-05-31T23:59:59+00:00",
        "vacationBalanceDays": 7.35,
        "vacationBalanceAsOf": "2026-06-26T23:59:59+00:00",
        "vacationEntitlementDays": 11.5,
        "vacationEntitlementAsOf": "2026-06-26T00:00:00+00:00"
      },
      "valid": null
    }
  ],
  "valid": true
}