Skip to content
Basenet
🇳🇱 Nederlands
🇳🇱 Nederlands🇬🇧 English
Esc
↑↓navigate↵open⌘Jpreview

List hour entries (scope hours:read)

GET/api/v1/hours
Authorization
AuthorizationBearer token · headerrequired

Scoped API token (bnx_…). Required scopes are noted per operation.

Query parameters
$topinteger

Page size ($top, max 200).

min 1 · max 200
$skipinteger

Offset ($skip).

min 0
Responses
200

Paginated list

itemsobject[]required
Show properties
Array of object
idstringrequired
matterIdstring | nullrequired
employeeUserIdstringrequired
datestringrequired
workedHoursnumberrequired
billableHoursnumberrequired
timeClassstringrequired
activityCodestring | nullrequired
timekeepingGroupstring | nullrequired
descriptionstringrequired
rateCentsinteger | nullrequired
rateSourcestring | nullrequired
rateResolutionReasonstring | nullrequired
invoiceIdstring | nullrequired
billableOverWorkedConfirmedbooleanrequired
createdAtstringrequired
updatedAtstringrequired
totalintegerrequired
skipintegerrequired
topintegerrequired
401

Unauthenticated

errorstringrequired
codestringrequired
rulestring
403

Forbidden (missing scope or permission)

errorstringrequired
codestringrequired
rulestring
429

Rate limited

errorstringrequired
codestringrequired
rulestring
Request
curl -X GET '/api/v1/hours' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{
  "items": [
    {
      "id": "string",
      "matterId": "string",
      "employeeUserId": "string",
      "date": "string",
      "workedHours": 0,
      "billableHours": 0,
      "timeClass": "string",
      "activityCode": "string",
      "timekeepingGroup": "string",
      "description": "string",
      "rateCents": 0,
      "rateSource": "string",
      "rateResolutionReason": "string",
      "invoiceId": "string",
      "billableOverWorkedConfirmed": true,
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "total": 0,
  "skip": 0,
  "top": 0
}