Skip to main content
POST
/
api
/
timeclock
/
timechecks.list
List timechecks
curl --request POST \
  --url https://api.example.com/api/timeclock/timechecks.list \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": [
    {
      "key": "timecheck.ids",
      "value": [
        "872815618512410358"
      ]
    }
  ]
}
'
[
  {
    "id": "872815618512410358",
    "legacy_id": 123,
    "resource": "872815618512410358",
    "duration": "PT1H30M20S",
    "time_range": "2019-11-11T12:34:56/2019-12-12T23:59:59",
    "expected_time_range": "2019-11-11T12:34:56/2019-12-12T23:59:59",
    "type": "device",
    "color": "<string>",
    "device": {
      "in": {
        "time": "2019-11-11T12:34:56",
        "name": "<string>",
        "beacon_name": "<string>",
        "autocorrection": "2019-11-11T12:34:56",
        "autocorrection_source": "<string>",
        "geolocation": {
          "latitude": null,
          "longitude": null,
          "accuracy": null
        },
        "received_at": "2025-10-30T10:40:22.01367Z"
      },
      "out": {
        "time": "2019-11-11T12:34:56",
        "name": "<string>",
        "beacon_name": "<string>",
        "autocorrection": "2019-11-11T12:34:56",
        "autocorrection_source": "<string>",
        "geolocation": {
          "latitude": null,
          "longitude": null,
          "accuracy": null
        },
        "received_at": "2025-10-30T10:40:22.01367Z"
      }
    },
    "proposal": {
      "resource": "872815618512410358",
      "in": "2019-11-11T12:34:56",
      "out": "2019-11-11T12:34:56",
      "received_at": "2025-10-30T10:40:22.01367Z",
      "comment": null
    },
    "validation": {
      "resource": "872815618512410358",
      "in": "2019-11-11T12:34:56",
      "out": "2019-11-11T12:34:56",
      "received_at": "2025-10-30T10:40:22.01367Z",
      "comment": null
    },
    "is_adjusted": true,
    "matched_schedules": [
      "872815618512410358"
    ],
    "tags_comment": "<string>",
    "tags": [
      {
        "id": "872815618512410358",
        "added_at": "2019-11-11T12:34:56",
        "added_by": "872815618512410358",
        "removed_at": "2019-11-11T12:34:56",
        "removed_by": "872815618512410358"
      }
    ],
    "permissions": {
      "can_validate": true,
      "can_edit": true
    }
  }
]

Body

application/json
filters
object[]

Response

200 - application/json
id
string<snowflake>
required
Example:

"872815618512410358"

legacy_id
integer
required
resource
string<snowflake>
required
Example:

"872815618512410358"

duration
string<duration>
required
Example:

"PT1H30M20S"

time_range
string<local-date-time-interval>
required
Example:

"2019-11-11T12:34:56/2019-12-12T23:59:59"

expected_time_range
string<local-date-time-interval>
required
Example:

"2019-11-11T12:34:56/2019-12-12T23:59:59"

type
enum<string>
required
Available options:
device,
proposal,
validation
Example:

"device"

color
string
required
device
object
required
proposal
object
required
validation
object
required
is_adjusted
boolean
required
matched_schedules
string<snowflake>[]
required
tags_comment
string | null
required
tags
object[]
required
permissions
object
required