Billing

Lists logged time across every ticket and task, narrowed by any of the filters.

One flat collection rather than a list per ticket, because time is pulled across tickets for billing sync, reporting and dashboards. Pass ticketIds to get a single ticket’s time.

Every filter is optional and combining two narrows to the entries that satisfy both. Each id filter is a comma-separated list and an entry matches if its id is any of them; a value that is not an id is rejected with 400. A well-formed value that matches nothing — a client id that does not exist, a ticket with no logged time — is an empty page, not a 404. Timestamps are UTC; each ...Since bound includes the instant it names and each ...Before bound excludes it, so two windows sharing an edge tile instead of both returning the entry on it.

ActualHours is the duration actually logged. AdjustedHours is the duration after the work type’s minimum and increment rounding, and is null when no rounding applied — in that case the billed duration is simply ActualHours.

Each entry names what it was logged against: an entry hangs off either a ticket or a task, so one of Ticket and Task carries the id, number and title, and the other is null.

GET

time-entries

Lists logged time across every ticket and task, narrowed by any of the filters.

curl --request GET \
  --url https://api.usw.gorelo.io/v1/time-entries \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.usw.gorelo.io/v1/time-entries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usw.gorelo.io/v1/time-entries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.usw.gorelo.io/v1/time-entries"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.usw.gorelo.io/v1/time-entries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": [
    {
      "Id": 88214,
      "Ticket": {
        "Id": "e5fb2939-3bd7-4893-8b47-a287003d5b8a",
        "Number": "T-1042",
        "Title": "Laptop will not boot after update"
      },
      "Task": {
        "Id": "e5fb2939-3bd7-4893-8b47-a287003d5b8a",
        "Number": "T-1042",
        "Title": "Laptop will not boot after update"
      },
      "User": {
        "Id": 1,
        "Name": "<string>"
      },
      "StartedOn": "2026-04-28T09:00:00.0000000+00:00",
      "EndedOn": "2026-04-28T10:30:00.0000000+00:00",
      "ActualHours": 1.5,
      "AdjustedHours": 1.75,
      "BillableStatus": {
        "Id": 1,
        "Name": "<string>"
      },
      "BillingRole": {
        "Id": 1,
        "Name": "<string>"
      },
      "WorkType": {
        "Id": 1,
        "Name": "<string>"
      },
      "ServiceLine": {
        "Id": 1,
        "Name": "<string>"
      },
      "Comment": "Replaced faulty NIC",
      "Distance": 12.5,
      "Attachments": [
        {
          "Name": "switch-photo.jpg",
          "Url": "https://files.example.com/switch-photo.jpg"
        }
      ],
      "CreatedOn": "2023-11-07T05:31:56Z",
      "UpdatedOn": "2023-11-07T05:31:56Z"
    }
  ],
  "DataContext": {
    "Pagination": {
      "NextCursor": "<string>",
      "PreviousCursor": "<string>",
      "HasMore": true,
      "HasPrevious": true,
      "TotalCount": 123
    }
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

授权

X-API-Key

string

header

必填

Your Gorelo API key. See Generate API key. If your data is hosted in Australia, click the base URL at the top of this page and select https://api.aue.gorelo.io.

查询参数

Cursor

string

Opaque pagination cursor from a previous page; omit for the first page. Only valid against the same filters that produced it.

PageSize

integer<int32>

默认值:50

Number of items per page, 1-200 (default 50). Out of range is rejected, not clamped.

ClientIds

string

Comma-separated client ids; keeps only time entries billed to any of them.

LocationIds

string

Comma-separated client location ids; keeps only time entries whose ticket sits at any of them. Entries logged against a task have no location and are excluded.

TicketIds

string

Comma-separated ticket ids; keeps only time entries logged against any of them.

TaskIds

string

Comma-separated task ids; keeps only time entries logged against any of them.

UserIds

string

Comma-separated user ids; keeps only time entries belonging to any of them.

InvoiceIds

string

Comma-separated invoice ids; keeps only time entries billed on any of them.

StartedSince

string<date-time>

ISO-8601 timestamp; keeps only time entries whose work started at or after it.

StartedBefore

string<date-time>

ISO-8601 timestamp; keeps only time entries whose work started strictly before it.

CreatedSince

string<date-time>

ISO-8601 timestamp; keeps only time entries created at or after it.

CreatedBefore

string<date-time>

ISO-8601 timestamp; keeps only time entries created strictly before it.

UpdatedSince

string<date-time>

ISO-8601 timestamp; keeps only time entries updated at or after it. An entry that has never been changed is excluded.

UpdatedBefore

string<date-time>

ISO-8601 timestamp; keeps only time entries updated strictly before it. An entry that has never been changed is excluded.

响应

StatusCode

enum<integer>

可用选项:

100,

101,

102,

103,

200,

201,

202,

203,

204,

205,

206,

207,

208,

226,

300,

301,

302,

303,

304,

305,

306,

307,

308,

400,

401,

402,

403,

404,

405,

406,

407,

408,

409,

410,

411,

412,

413,

414,

415,

416,

417,

421,

422,

423,

424,

426,

428,

429,

431,

451,

500,

501,

502,

503,

504,

505,

506,

507,

508,

510,

511

IsSuccess

boolean

Data

object[] | null

Show child attributes

DataContext

object

The DataContext of a cursor-paginated success response: carries the paging metadata for the returned page.

Show child attributes

Notifications

object[]

Show child attributes

⌘I

Lists logged time across every ticket and task, narrowed by any of the filters.

curl --request GET \
  --url https://api.usw.gorelo.io/v1/time-entries \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.usw.gorelo.io/v1/time-entries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usw.gorelo.io/v1/time-entries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.usw.gorelo.io/v1/time-entries"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.usw.gorelo.io/v1/time-entries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": [
    {
      "Id": 88214,
      "Ticket": {
        "Id": "e5fb2939-3bd7-4893-8b47-a287003d5b8a",
        "Number": "T-1042",
        "Title": "Laptop will not boot after update"
      },
      "Task": {
        "Id": "e5fb2939-3bd7-4893-8b47-a287003d5b8a",
        "Number": "T-1042",
        "Title": "Laptop will not boot after update"
      },
      "User": {
        "Id": 1,
        "Name": "<string>"
      },
      "StartedOn": "2026-04-28T09:00:00.0000000+00:00",
      "EndedOn": "2026-04-28T10:30:00.0000000+00:00",
      "ActualHours": 1.5,
      "AdjustedHours": 1.75,
      "BillableStatus": {
        "Id": 1,
        "Name": "<string>"
      },
      "BillingRole": {
        "Id": 1,
        "Name": "<string>"
      },
      "WorkType": {
        "Id": 1,
        "Name": "<string>"
      },
      "ServiceLine": {
        "Id": 1,
        "Name": "<string>"
      },
      "Comment": "Replaced faulty NIC",
      "Distance": 12.5,
      "Attachments": [
        {
          "Name": "switch-photo.jpg",
          "Url": "https://files.example.com/switch-photo.jpg"
        }
      ],
      "CreatedOn": "2023-11-07T05:31:56Z",
      "UpdatedOn": "2023-11-07T05:31:56Z"
    }
  ],
  "DataContext": {
    "Pagination": {
      "NextCursor": "<string>",
      "PreviousCursor": "<string>",
      "HasMore": true,
      "HasPrevious": true,
      "TotalCount": 123
    }
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}