Time Entry

Get Time Entries

Time activities are predefined task categories that users can reference when logging time entries in the time-tracking system.

By standardising task types, predefined activities enhance reporting accuracy, providing insights into the specific work required to complete a project.

READ access to the ADMIN module is required to access this endpoint

Currently, only users with Administrative level have access to view, create and modify time entries for other users time entries.

All users are able to create, edit and delete their own time entries, however this uses a separate API not currently available for public access.

Please contact our Support team if you are interested in accessing this private API.

GET

time-entry

curl --request GET \
  --url https://api.sonderplan.com/v2/time-entry \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": 9879871,
      "owner_id": 872383,
      "owner": {
        "id": 4,
        "first_name": "Jane",
        "last_name": "Smith",
        "primary_email": "[email protected]",
        "icon": {
          "id": 2390323,
          "name": "SCR-20250220-jnua",
          "alias": "030fb130bdf3c6cd5fa533fabb26fc9d90b66542cd343a318b2bfe5474923f90",
          "extension": "jpeg",
          "mime_type": "image/jpeg"
        }
      },
      "name": "Colour Grading",
      "description": "Opening scenes completed",
      "start": 1547501100,
      "end": 1547538900,
      "start_date_time_iso": "2022-02-22T09:00:00+11:00",
      "end_date_time_iso": "2022-02-22T17:00:00+11:00",
      "duration_sec": "3600",
      "project": [
        {
          "id": 2342354,
          "name": "Andor S1 EP7 Annoucement",
          "code": "AND-S1-EP7",
          "description": "Colonel Yularen announces that the ISB has gained more surveillance and punitive authority, while Meero is challenged by Blevin for breaking protocol by accessing Imperial data without authorization.",
          "status_id": 1
        }
      ],
      "booking": [
        {
          "id": 1,
          "name": "Test Booking",
          "start": 1547501100,
          "end": 1547538900,
          "resources": [
            {
              "id": 9458,
              "name": "Edit Suite 1"
            }
          ]
        }
      ],
      "billable": "false",
      "locked": "false",
      "created_id": 3,
      "created": 1388552400,
      "updated_id": 3,
      "updated": 1388552400
    }
  ],
  "meta": {
    "pagination": {
      "total": 1,
      "count": 1,
      "per_page": 1,
      "current_page": 1
    }
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

string

One or more (comma seperated) IDs of time entries to retrieve

project_id

string

One or more (comma seperated) project ids to retrieve associated time entries

booking_id

string

One or more (comma seperated) booking ids to retrieve associated time entries

fields

string

Comma seperated list of fields you wish to return

page

integer

Specify the page of results you wish to return

limit

integer

The number of results returned per page. Default if not specified is 10

order_asc

string

Specify the field (with type of string or integer) you wish to order (ascending) the response with

order_desc

string

Specify the field (with type of string or integer) you wish to order (descending) the response with

filter_operator

enum<string>

default:OR

Specify if multiple filters should be combined with OR or AND logic

Available options:

OR,

AND

Response

200

application/json

Successful Operation

data

object[]

Stores time entries on bookings and projects

data.id

integer

Automatically generated, unique time entry id

Example:

9879871

data.owner_id

integer

ID of the user that owns this time entry

Example:

872383

data.owner

object

User that owns this time entry

data.name

string

Name of the activity that is being worked on

Example:

"Colour Grading"

data.description

string

Short description or notes about what was worked on

Example:

"Opening scenes completed"

data.start

integer

Unix Time Entry Start

Example:

1547501100

data.end

integer

Unix Time Entry End

Example:

1547538900

data.start_date_time_iso

string

ISO-8601 formatted result of the time entry start

Example:

"2022-02-22T09:00:00+11:00"

data.end_date_time_iso

string

ISO-8601 formatted result of the time entry end

Example:

"2022-02-22T17:00:00+11:00"

data.duration_sec

integer

Duration of time entry in seconds

Example:

"3600"

data.project

object[]

Simplified project model containing only a subset of fields

data.booking

object[]

Standrd booking model summarised

data.billable

boolean

Is the time tracked billable?

Example:

"false"

data.locked

boolean

Is this time entry locked for further changes?

Example:

"false"

data.created_id

integer

The unique ID of the person (user) who created this record

Example:

3

data.created

integer

The UNIX time value of the creation time

Example:

1388552400

data.updated_id

integer

The unique ID of the person (user) who last updated this record

Example:

3

data.updated

integer

The UNIX time value of the last update

Example:

1388552400

meta

object

Delete Time Activity Update Time Entry

curl --request GET \
  --url https://api.sonderplan.com/v2/time-entry \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": 9879871,
      "owner_id": 872383,
      "owner": {
        "id": 4,
        "first_name": "Jane",
        "last_name": "Smith",
        "primary_email": "[email protected]",
        "icon": {
          "id": 2390323,
          "name": "SCR-20250220-jnua",
          "alias": "030fb130bdf3c6cd5fa533fabb26fc9d90b66542cd343a318b2bfe5474923f90",
          "extension": "jpeg",
          "mime_type": "image/jpeg"
        }
      },
      "name": "Colour Grading",
      "description": "Opening scenes completed",
      "start": 1547501100,
      "end": 1547538900,
      "start_date_time_iso": "2022-02-22T09:00:00+11:00",
      "end_date_time_iso": "2022-02-22T17:00:00+11:00",
      "duration_sec": "3600",
      "project": [
        {
          "id": 2342354,
          "name": "Andor S1 EP7 Annoucement",
          "code": "AND-S1-EP7",
          "description": "Colonel Yularen announces that the ISB has gained more surveillance and punitive authority, while Meero is challenged by Blevin for breaking protocol by accessing Imperial data without authorization.",
          "status_id": 1
        }
      ],
      "booking": [
        {
          "id": 1,
          "name": "Test Booking",
          "start": 1547501100,
          "end": 1547538900,
          "resources": [
            {
              "id": 9458,
              "name": "Edit Suite 1"
            }
          ]
        }
      ],
      "billable": "false",
      "locked": "false",
      "created_id": 3,
      "created": 1388552400,
      "updated_id": 3,
      "updated": 1388552400
    }
  ],
  "meta": {
    "pagination": {
      "total": 1,
      "count": 1,
      "per_page": 1,
      "current_page": 1
    }
  }
}

Instance

Billable Item

Booking

Calendar Subscription

Contact

Custom Field

Group

Invoice

Quote

Invoice Template

User

Project

Rate Scheme

Resource

Workspace

Status

Tax

Time Activity

Time Entry

Get Time Entries

Authorizations

Query Parameters

Response