Skip to main content
Browse the docs

List job, visit and assessment time visible to this member

GET/api/v1/time_entries

Managers can view the team; other members see their own time. Date filters include entries overlapping the requested interval.

  • Needs an API key, and runs with the access of the member who made the key.
  • A connected AI assistant can use it too, as listTimeEntries.

Parameters

In the query string

  • pageinteger

    Default: 1. At least 1.

  • per_pageinteger

    Default: 50. At least 1. At most 100.

  • visit_idstring (uuid)

    Filter time on a visit (work or quote assessment).

  • job_idstring (uuid)

  • membership_idstring (uuid)

    Manager-only filter.

  • runningboolean

  • fromstring (date-time)

  • tostring (date-time)

Responses

200Paginated job time entries.

  • dataarray of objectrequired

    Each item(19)

    • lock_versionintegerrequired

      At least 0.

    • created_atstring (date-time)required

    • updated_atstring (date-time)required

    • idstring (uuid)required

    • account_idstring (uuid)required

    • job_idstring (uuid) or nullrequired

    • job_titlestring or nullrequired

    • job_numberstring or nullrequired

    • visit_idstring (uuid) or null

    • visit_titlestring or null

    • purposestring

      `work` for job and work-visit time, `quote_assessment` for quote visit time.

      One of: work, quote_assessment.

    • membership_idstring (uuid)required

    • membership_namestringrequired

    • recorded_by_idstring (uuid)required

    • updated_by_idstring (uuid)required

    • started_atstring (date-time)required

    • ended_atstring (date-time) or nullrequired

    • duration_secondsintegerrequired

      At least 0.

    • notesstring or null

  • metaobjectrequired

    Fields(4)

    • pageintegerrequired

      At least 1.

    • per_pageintegerrequired

      At least 1. At most 100.

    • totalintegerrequired

      At least 0.

    • total_pagesintegerrequired

      At least 0.

A refusal answers in the one error shape every operation shares.

Example

A request our own tests send. The ids are made up: put your own in their place.

curl "https://app.tradesender.co.uk/api/v1/time_entries?job_id=4088bebb-3a71-586f-922c-1612b3fa6557" \
  -H "Authorization: Bearer $TRADESENDER_KEY"