Skip to Content
DevelopersAPI referenceTime

List times

GET
/v1/time-entries

Authorization

apiKey
headerAuthorizationBearer <token>

An API key (blk_…) from Settings → API keys.

Query Parameters

from*string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatdate
to*string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatdate
projectId?string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
tagId?string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
memberId?|
billable?string
Value in"true""false"
uninvoiced?"true"
Value in"true"

Response Body

application/json
  1. response
items*array<>
totalSeconds*integer
Range-9007199254740991 <= value <= 9007199254740991
billableSeconds*integer
Range-9007199254740991 <= value <= 9007199254740991
Example Request
curl -X GET 'https://your-billleaf-api/v1/time-entries?from=2019-08-24&to=2019-08-24'
Example Response200
{  "items": [    {      "id": "string",      "projectId": "string",      "projectName": "string",      "clientName": "string",      "taskId": "string",      "taskTitle": "string",      "memberId": "string",      "memberName": "string",      "description": "string",      "entryDate": "2019-08-24",      "startedAt": "2019-08-24T14:15:22Z",      "endedAt": "2019-08-24T14:15:22Z",      "durationSeconds": -9007199254740991,      "hasTimes": true,      "billable": true,      "tags": [        {          "id": "string",          "name": "string",          "color": "gray"        }      ],      "invoiceId": "string",      "invoiceNumber": "string",      "isRunning": true,      "isMine": true,      "approvalLocked": true,      "periodLocked": true    }  ],  "totalSeconds": -9007199254740991,  "billableSeconds": -9007199254740991}