Skip to main content

TimeSheetItemResponse

Single time sheet response

response_codeinteger

HTTP status code of the response for reference purposes.

Default value: 200
Example: 200
results object

Time entry sheet.

See the Entry Sheet API tutorial for a discussion of the structure of the sheet, especially the rows key which contains the actual time entries.

idstring

The internal ID of the resource or object. This is a 32-character hexadecimal string (UUID without hyphens).

In general, the id field is the primary key of the object and cannot be changed or updated.

Example: 64BBA147B9AC41D9978062300826C89F
uristring<uri-reference>

The URI associated with this resource. This is usually a relative URL that can be used to access the resource. Typically it incorporates the Unique ID of the resource.

Example: /api/v1/objects/64BBA147B9AC41D9978062300826C89F
tablenamestring

The name of the internal database table associated with this resource.

Example: users
table_labelstring

The user-visible label of the database table associated with this object.

Example: codes_pay_types
creatorstring

The internal User ID of the user who created the object.

Example: 64BBA147B9AC41D9978062300826C89F
creator_fullnamestring

The full name of the user who created the object.

Example: John Doe
creator_properties object

Full user record for the creator. This may not be included unless requested in $keys.

idstring

The internal ID of the resource or object. This is a 32-character hexadecimal string (UUID without hyphens).

In general, the id field is the primary key of the object and cannot be changed or updated.

Example: 64BBA147B9AC41D9978062300826C89F
uristring<uri-reference>

The URI associated with this resource. This is usually a relative URL that can be used to access the resource. Typically it incorporates the Unique ID of the resource.

Example: /api/v1/objects/64BBA147B9AC41D9978062300826C89F
tablenamestring

The name of the internal database table associated with this resource.

Example: users
table_labelstring

The user-visible label of the database table associated with this object.

Example: codes_pay_types
custom_fields object

An object with Custom Fields for this record. The key is the field ID and the value a description of the field. Additional details here: CustomFields Schema

tip

Updating Custom Field values

When creating or updating an existing object that uses Custom Fields, for example a User record, you can follow this custom_field key structure to update the custom field values. The value field is the only required field for updating a custom field value; other fields such as pname will be ignored.

info

Important: depending on the endpoint, this may only be included in the response if $keys=custom_fields or $keys=$extended was set as a query parameter.

There is also a more compact representation available in most object types, where each custom field value is a separate key in the main object (not under custom_fields).

See the CustomFields Schema page for more detailed information on these topics.

property name* CustomFieldValue

A specific instance (value) of a Custom field for a particular object.

id_attr_typestring

The unique internal ID of this Custom Field definition (same as id field)

Example: 2DDD372DC4D3422D9E73F6DE936C4265
attr_typestring

Datatype of the custom field. The basic types available are:

  • STRING - a variable-length string.
  • CHAR - a fixed-length string. (The value may be padded with spaces.)
  • NUMBER - a floating-point number.
  • INTEGER - an integer (whole number).
  • TIMESTAMP - a date and time, stored in Unix epoch format.
  • DATE - a YYYYMMDD (F8) date.

In addition, most types can be modified with a prefix to indicate whether they are "select lists" (ENUM or enumerated) or "multi-select lists" (M_ENUM) which can take on multiple values.

Strings and char may also have a maximum length specified, such as STRING_100.

Example: STRING_100
descriptionstring

Description of custom field

pnamestring

Name of custom field

Example: Pay Group
id_attr_type_uristring

URI of the custom field to get more information about the custom field definition.

Example: /api/v1/custom_fields/E07526A217164D1B94188279A8A0E4D9
valuestring

Value of the custom field for this object. To update the value, see the note on the CustomFields schema page.

Note that when modifying Custom Fields of objects like Users or Projects, only the value key will be checked; other fields like the Custom Field pname will be ignored.

Example: XYZ Pay Group
group_names object[]

A list of Groups (names and IDs) that the object belongs to.

This is a read-only list. To change the Groups that an object belongs to, use the groups field.

See GroupFields for additional information about Groups and this field.

  • Array [
  • idstring

    The Group ID (32-character hexadecimal string).

    pnamestring

    The Group name.

    uristring

    The URI of the Group.

    WARNING: this field is planned in a future release but is not yet available.

  • ]
  • groupsstring[]

    A list of Group IDs that the object belongs to. See GroupFields for additional information about Groups and this field.

    Example: ["5088C427E8B64EBEBE1C5B5961DB1902","3553F715A6F54DAB95D0D25B08468195","5088C427E8B64EBEBE1C5B5961DB1902","3553F715A6F54DAB95D0D25B08468195"]
    is_hiddenboolean

    Indicates whether the object is hidden.

    See also status

    hiddenboolean

    Indicates whether the user is hidden.

    Read-only alias for is_hidden.

    statusstring

    The status of the user; either hidden, active, or inactive.

    Possible values: [Hidden, Loggable and Reportable, Reportable Only]

    Example: Loggable and Reportable
    status_codestring

    The internal code for the status of the object; either:

    • lr for Loggable and Reportable
    • ro for Reportable Only
    • h for Hidden

    Possible values: [h, lr, ro]

    Example: lr
    user_loginstringrequired

    The login name of the user.

    Example: john.smith@example.com
    fullnamestringrequired

    The full name of the user.

    Example: John Smith
    u_commentstring

    The default comment on the user's time entry screen.

    default_memorized_sheetstring

    The ID of the user's default memorized timesheet.

    dropdownthresholdinteger

    The number of items in a selection list to trigger a forced search.

    hideboolean

    Indicates whether the user is hidden.

    Note: the User object is the only one that uses this field; other objects use is_hidden.

    expire_new_pwboolean

    Whether the user's new password should expire after the first login.

    This is a write-only field that does not appear in User object responses.

    new_pwstring

    The new password for the user.

    The password must also be set in the new_pw2 field to confirm the change.

    This is a write-only field that does not appear in User object responses.

    new_pw2string

    The new password for the user, repeated to confirm the change.

    The password must also be set in the new_pw field to confirm the change.

    This is a write-only field that does not appear in User object responses.

    rolesstring[]

    A list of role IDs belonging to this user.

    This list can be modified to change the user's roles.

    timerecs_ininteger

    The number of blank rows to show on the entry screen.

    Example: 3
    time_periodstring

    The "Entry Screen period" (time-span) associated with the user's Time Entry screen.

    Example: default_weekly
    expense_periodstring

    The "Entry Screen period" (time-span) associated with the user's Expense Entry screen.

    Example: default_weekly
    custom_periodstring

    The "Entry Screen period" (time-span) associated with the user's Custom Entry screen.

    Example: default_weekly
    expense_guistring

    The ID of the user's assigned Expense entry screen configuration.

    time_guistring

    The ID of the user's assigned time entry screen configuration.

    travel_guistring

    The ID of the user's assigned Custom Entry (a.k.a. Mileage or Travel) entry screen configuration.

    create_timestampnumber<float>

    The timestamp when the object was created, in Unix epoch format. This is the number of seconds since 1970-01-01T00:00:00Z.

    Example: 1696021987.01375
    create_timestamp_date_longstring

    The object creation date in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023
    create_timestamp_date_shortstring

    The object creation date in the "short date" format defined in the system settings.

    Example: 03/22/2023
    create_timestamp_datetime_longstring

    The object creation date and time in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023 12:18:46 CDT
    create_timestamp_datetime_shortstring

    The object creation date and time in the "short date" format defined in the system settings.

    Example: 03/22/2023 12:18:46 CDT
    create_timestamp_isostring<date-time>

    The creation timestamp in ISO 8601 format.

    Example: 2023-03-22T12:18:46-05:00
    modifierstring

    The internal User ID of the user who most recently modified the object.

    Example: 64BBA147B9AC41D9978062300826C89F
    modifier_fullnamestring

    The full name of the user who most recently modified the object.

    Example: John Doe
    modifier_propertiesobject

    Extended information about the User who last modified the object. This field is only included if the $keys parameter requests it.

    modify_timestampnumber<float>

    The timestamp when the object was most recently modified, in Unix epoch format. This is the number of seconds since 1970-01-01T00:00:00Z.

    Example: 1696021987.01375
    modify_timestamp_date_longstring

    The last modification date in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023
    modify_timestamp_date_shortstring

    The last modification date in the "short date" format defined in the system settings.

    Example: 03/22/2023
    modify_timestamp_datetime_longstring

    The last modification date and time in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023 12:18:46 CDT
    modify_timestamp_datetime_shortstring

    The last modification date and time in the "short date" format defined in the system settings.

    Example: 03/22/2023 12:18:46 CDT
    modify_timestamp_isostring<date-time>

    The last modification timestamp in ISO 8601 format.

    Example: 2023-03-22T12:18:46-05:00
    id_domainstring

    The internal Domain ID of the resource or object. In general, this field is deprecated and not in use and can be ignored.

    Example: install_root_dom
    daysinlistinteger

    UNUSED FIELD This is a legacy field that is no longer used.

    emailstring

    The email address of the user.

    Note: This is a read-only field. To change the user's email address, you must modify the users_attribs:users_email field, or custom_fields.users_email.value.

    first_namestring

    The first name of the user.

    Note: read-only; set via the fullname field.

    id_userstring

    The unique internal ID of this user. (Same as id.)

    Example: 5CD906A3941C463B9CC98F49DBCC25AA
    last_namestring

    The last name of the user.

    Note: read-only; set via the fullname field.

    memorized_sheet_choices object[]

    A list of memorized timesheets associated with the user.

    These are the choices available to set in the default_memorized_sheet field.

  • Array [
  • valuestring

    The internal ID of the memorized timesheet.

    textstring

    The name of the memorized timesheet.

  • ]
  • reserved1string

    UNUSED FIELD This is a legacy field that is no longer used.

    reserved2number<float>

    UNUSED FIELD This is a legacy field that is no longer used.

    reserved3number<float>

    UNUSED FIELD This is a legacy field that is no longer used.

    timerecs_outinteger

    UNUSED FIELD This is a legacy field that is no longer used.

    time_gui_propertiesobject

    Details about the user's assigned time entry screen configuration.

    travel_gui_propertiesobject

    Details about the user's assigned Custom Entry (a.k.a. Mileage or Travel) entry screen configuration.

    expense_gui_propertiesobject

    Details about the user's assigned Expense entry screen configuration.

    creatorstring

    The internal User ID of the user who created the object.

    Example: 64BBA147B9AC41D9978062300826C89F
    creator_fullnamestring

    The full name of the user who created the object.

    Example: John Doe
    creator_propertiesobject

    Extended information about the User who created the object. This field is only included if the $keys parameter requests it.

    create_timestampnumber<float>

    The timestamp when the object was created, in Unix epoch format. This is the number of seconds since 1970-01-01T00:00:00Z.

    Example: 1696021987.01375
    create_timestamp_date_longstring

    The object creation date in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023
    create_timestamp_date_shortstring

    The object creation date in the "short date" format defined in the system settings.

    Example: 03/22/2023
    create_timestamp_datetime_longstring

    The object creation date and time in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023 12:18:46 CDT
    create_timestamp_datetime_shortstring

    The object creation date and time in the "short date" format defined in the system settings.

    Example: 03/22/2023 12:18:46 CDT
    create_timestamp_isostring<date-time>

    The creation timestamp in ISO 8601 format.

    Example: 2023-03-22T12:18:46-05:00
    modifierstring

    The internal User ID of the user who most recently modified the object.

    Example: 64BBA147B9AC41D9978062300826C89F
    modifier_fullnamestring

    The full name of the user who most recently modified the object.

    Example: John Doe
    modifier_properties object

    Full user record for the last modifier. This may not be included unless requested in $keys.

    idstring

    The internal ID of the resource or object. This is a 32-character hexadecimal string (UUID without hyphens).

    In general, the id field is the primary key of the object and cannot be changed or updated.

    Example: 64BBA147B9AC41D9978062300826C89F
    uristring<uri-reference>

    The URI associated with this resource. This is usually a relative URL that can be used to access the resource. Typically it incorporates the Unique ID of the resource.

    Example: /api/v1/objects/64BBA147B9AC41D9978062300826C89F
    tablenamestring

    The name of the internal database table associated with this resource.

    Example: users
    table_labelstring

    The user-visible label of the database table associated with this object.

    Example: codes_pay_types
    custom_fields object

    An object with Custom Fields for this record. The key is the field ID and the value a description of the field. Additional details here: CustomFields Schema

    tip

    Updating Custom Field values

    When creating or updating an existing object that uses Custom Fields, for example a User record, you can follow this custom_field key structure to update the custom field values. The value field is the only required field for updating a custom field value; other fields such as pname will be ignored.

    info

    Important: depending on the endpoint, this may only be included in the response if $keys=custom_fields or $keys=$extended was set as a query parameter.

    There is also a more compact representation available in most object types, where each custom field value is a separate key in the main object (not under custom_fields).

    See the CustomFields Schema page for more detailed information on these topics.

    property name* CustomFieldValue

    A specific instance (value) of a Custom field for a particular object.

    id_attr_typestring

    The unique internal ID of this Custom Field definition (same as id field)

    Example: 2DDD372DC4D3422D9E73F6DE936C4265
    attr_typestring

    Datatype of the custom field. The basic types available are:

    • STRING - a variable-length string.
    • CHAR - a fixed-length string. (The value may be padded with spaces.)
    • NUMBER - a floating-point number.
    • INTEGER - an integer (whole number).
    • TIMESTAMP - a date and time, stored in Unix epoch format.
    • DATE - a YYYYMMDD (F8) date.

    In addition, most types can be modified with a prefix to indicate whether they are "select lists" (ENUM or enumerated) or "multi-select lists" (M_ENUM) which can take on multiple values.

    Strings and char may also have a maximum length specified, such as STRING_100.

    Example: STRING_100
    descriptionstring

    Description of custom field

    pnamestring

    Name of custom field

    Example: Pay Group
    id_attr_type_uristring

    URI of the custom field to get more information about the custom field definition.

    Example: /api/v1/custom_fields/E07526A217164D1B94188279A8A0E4D9
    valuestring

    Value of the custom field for this object. To update the value, see the note on the CustomFields schema page.

    Note that when modifying Custom Fields of objects like Users or Projects, only the value key will be checked; other fields like the Custom Field pname will be ignored.

    Example: XYZ Pay Group
    group_names object[]

    A list of Groups (names and IDs) that the object belongs to.

    This is a read-only list. To change the Groups that an object belongs to, use the groups field.

    See GroupFields for additional information about Groups and this field.

  • Array [
  • idstring

    The Group ID (32-character hexadecimal string).

    pnamestring

    The Group name.

    uristring

    The URI of the Group.

    WARNING: this field is planned in a future release but is not yet available.

  • ]
  • groupsstring[]

    A list of Group IDs that the object belongs to. See GroupFields for additional information about Groups and this field.

    Example: ["5088C427E8B64EBEBE1C5B5961DB1902","3553F715A6F54DAB95D0D25B08468195","5088C427E8B64EBEBE1C5B5961DB1902","3553F715A6F54DAB95D0D25B08468195"]
    is_hiddenboolean

    Indicates whether the object is hidden.

    See also status

    hiddenboolean

    Indicates whether the user is hidden.

    Read-only alias for is_hidden.

    statusstring

    The status of the user; either hidden, active, or inactive.

    Possible values: [Hidden, Loggable and Reportable, Reportable Only]

    Example: Loggable and Reportable
    status_codestring

    The internal code for the status of the object; either:

    • lr for Loggable and Reportable
    • ro for Reportable Only
    • h for Hidden

    Possible values: [h, lr, ro]

    Example: lr
    user_loginstringrequired

    The login name of the user.

    Example: john.smith@example.com
    fullnamestringrequired

    The full name of the user.

    Example: John Smith
    u_commentstring

    The default comment on the user's time entry screen.

    default_memorized_sheetstring

    The ID of the user's default memorized timesheet.

    dropdownthresholdinteger

    The number of items in a selection list to trigger a forced search.

    hideboolean

    Indicates whether the user is hidden.

    Note: the User object is the only one that uses this field; other objects use is_hidden.

    expire_new_pwboolean

    Whether the user's new password should expire after the first login.

    This is a write-only field that does not appear in User object responses.

    new_pwstring

    The new password for the user.

    The password must also be set in the new_pw2 field to confirm the change.

    This is a write-only field that does not appear in User object responses.

    new_pw2string

    The new password for the user, repeated to confirm the change.

    The password must also be set in the new_pw field to confirm the change.

    This is a write-only field that does not appear in User object responses.

    rolesstring[]

    A list of role IDs belonging to this user.

    This list can be modified to change the user's roles.

    timerecs_ininteger

    The number of blank rows to show on the entry screen.

    Example: 3
    time_periodstring

    The "Entry Screen period" (time-span) associated with the user's Time Entry screen.

    Example: default_weekly
    expense_periodstring

    The "Entry Screen period" (time-span) associated with the user's Expense Entry screen.

    Example: default_weekly
    custom_periodstring

    The "Entry Screen period" (time-span) associated with the user's Custom Entry screen.

    Example: default_weekly
    expense_guistring

    The ID of the user's assigned Expense entry screen configuration.

    time_guistring

    The ID of the user's assigned time entry screen configuration.

    travel_guistring

    The ID of the user's assigned Custom Entry (a.k.a. Mileage or Travel) entry screen configuration.

    creatorstring

    The internal User ID of the user who created the object.

    Example: 64BBA147B9AC41D9978062300826C89F
    creator_fullnamestring

    The full name of the user who created the object.

    Example: John Doe
    creator_propertiesobject

    Extended information about the User who created the object. This field is only included if the $keys parameter requests it.

    create_timestampnumber<float>

    The timestamp when the object was created, in Unix epoch format. This is the number of seconds since 1970-01-01T00:00:00Z.

    Example: 1696021987.01375
    create_timestamp_date_longstring

    The object creation date in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023
    create_timestamp_date_shortstring

    The object creation date in the "short date" format defined in the system settings.

    Example: 03/22/2023
    create_timestamp_datetime_longstring

    The object creation date and time in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023 12:18:46 CDT
    create_timestamp_datetime_shortstring

    The object creation date and time in the "short date" format defined in the system settings.

    Example: 03/22/2023 12:18:46 CDT
    create_timestamp_isostring<date-time>

    The creation timestamp in ISO 8601 format.

    Example: 2023-03-22T12:18:46-05:00
    modify_timestampnumber<float>

    The timestamp when the object was most recently modified, in Unix epoch format. This is the number of seconds since 1970-01-01T00:00:00Z.

    Example: 1696021987.01375
    modify_timestamp_date_longstring

    The last modification date in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023
    modify_timestamp_date_shortstring

    The last modification date in the "short date" format defined in the system settings.

    Example: 03/22/2023
    modify_timestamp_datetime_longstring

    The last modification date and time in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023 12:18:46 CDT
    modify_timestamp_datetime_shortstring

    The last modification date and time in the "short date" format defined in the system settings.

    Example: 03/22/2023 12:18:46 CDT
    modify_timestamp_isostring<date-time>

    The last modification timestamp in ISO 8601 format.

    Example: 2023-03-22T12:18:46-05:00
    id_domainstring

    The internal Domain ID of the resource or object. In general, this field is deprecated and not in use and can be ignored.

    Example: install_root_dom
    daysinlistinteger

    UNUSED FIELD This is a legacy field that is no longer used.

    emailstring

    The email address of the user.

    Note: This is a read-only field. To change the user's email address, you must modify the users_attribs:users_email field, or custom_fields.users_email.value.

    first_namestring

    The first name of the user.

    Note: read-only; set via the fullname field.

    id_userstring

    The unique internal ID of this user. (Same as id.)

    Example: 5CD906A3941C463B9CC98F49DBCC25AA
    last_namestring

    The last name of the user.

    Note: read-only; set via the fullname field.

    memorized_sheet_choices object[]

    A list of memorized timesheets associated with the user.

    These are the choices available to set in the default_memorized_sheet field.

  • Array [
  • valuestring

    The internal ID of the memorized timesheet.

    textstring

    The name of the memorized timesheet.

  • ]
  • reserved1string

    UNUSED FIELD This is a legacy field that is no longer used.

    reserved2number<float>

    UNUSED FIELD This is a legacy field that is no longer used.

    reserved3number<float>

    UNUSED FIELD This is a legacy field that is no longer used.

    timerecs_outinteger

    UNUSED FIELD This is a legacy field that is no longer used.

    time_gui_propertiesobject

    Details about the user's assigned time entry screen configuration.

    travel_gui_propertiesobject

    Details about the user's assigned Custom Entry (a.k.a. Mileage or Travel) entry screen configuration.

    expense_gui_propertiesobject

    Details about the user's assigned Expense entry screen configuration.

    modifierstring

    The internal User ID of the user who most recently modified the object.

    Example: 64BBA147B9AC41D9978062300826C89F
    modifier_fullnamestring

    The full name of the user who most recently modified the object.

    Example: John Doe
    modifier_propertiesobject

    Extended information about the User who last modified the object. This field is only included if the $keys parameter requests it.

    modify_timestampnumber<float>

    The timestamp when the object was most recently modified, in Unix epoch format. This is the number of seconds since 1970-01-01T00:00:00Z.

    Example: 1696021987.01375
    modify_timestamp_date_longstring

    The last modification date in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023
    modify_timestamp_date_shortstring

    The last modification date in the "short date" format defined in the system settings.

    Example: 03/22/2023
    modify_timestamp_datetime_longstring

    The last modification date and time in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023 12:18:46 CDT
    modify_timestamp_datetime_shortstring

    The last modification date and time in the "short date" format defined in the system settings.

    Example: 03/22/2023 12:18:46 CDT
    modify_timestamp_isostring<date-time>

    The last modification timestamp in ISO 8601 format.

    Example: 2023-03-22T12:18:46-05:00
    id_sheetstringrequired

    Unique identifier for the entry sheet (same as id)

    Example: 0B04998DCD0E45DF9D0EC97EC926D281
    id_userstringrequired

    User ID of the sheet owner

    Example: alice
    userstring

    User login/ID (same as id_user)

    Example: alice
    user_loginstring

    User login name

    Example: alice@company.com
    user_namestring

    Full display name of the user

    Example: Alice Dev
    id_timesheetstring

    ID of the timesheet period configuration (e.g., "default_weekly"). Determines the period frequency and start day.

    Note: not to be confused with id_sheet, which is the unique sheet instance ID. The id_timesheet field refers to the TIME PERIOD definition of the sheet, i.e., weekly vs. monthly.

    Example: default_weekly
    typestringrequired

    Type of entry sheet:

    • time - Time tracking entries
    • expense - Expense entries
    • mileage - Custom/mileage/travel entries

    Possible values: [time, expense, mileage]

    Example: time
    statestring

    Current approval state of the sheet:

    • open - Editable by user
    • submitted - Awaiting approval
    • approved - Approved by all required levels
    • rejected - Rejected and returned to user

    Possible values: [open, submitted, approved, rejected]

    Example: open
    state_flagnumber<float>

    Numeric representation of state:

    • 0.0 - open
    • 1.0 - submitted
    • 2.0 - approved
    • 3.0 - rejected
    Example: 0
    start_datestringrequired

    Period start date in F8 format (YYYYMMDD)

    Possible values: Value must match regular expression ^\d{8}$

    Example: 20251102
    end_datestringrequired

    Period end date in F8 format (YYYYMMDD)

    Possible values: Value must match regular expression ^\d{8}$

    Example: 20251108
    datesstring[]required

    Array of all dates in the period (F8 / YYYYMMDD format)

    Possible values: Value must match regular expression ^\d{8}$

    Example: ["20251102","20251103","20251104","20251105","20251106","20251107","20251108"]
    rodstring

    Concatenated representation of all dates (Record Of Dates). Mainly an internal use field that can be ignored.

    Example: 20251102202511032025110420251105202511062025110720251108
    totalnumber<float>

    Sum of all entry amounts in the sheet. Computed field - calculated from underlying entry records.

    Example: 40
    entry_countinteger

    Count of entry records in the sheet. Computed field - calculated from underlying entry records.

    Example: 5
    levelinteger

    Current approval level (0 = not submitted, 1+ = approval level).

    Example: 0
    interim_sheetboolean

    Whether this is a interim-submitted ("virtual") sheet. Interim sheets allow partial submission while keeping the main sheet open.

    Example: false
    sheet_tablestring

    Database table name for this sheet type:

    • user_time_sheets or virtual_time_sheets
    • user_expense_sheets or virtual_expense_sheets
    • user_travel_sheets or virtual_custom_sheets
    Example: user_time_sheets
    sheet_statusstring

    Human-readable status message

    Example: Open for Entry
    pnamestring

    Display name for the sheet (formatted date range)

    Example: 11/02/2025 - 11/08/2025
    modified_atstring<date-time>

    ISO 8601 timestamp of the most recent modification across all related data. May differ from modify_timestamp if related records were changed.

    Example: 2025-11-03T12:56:20-06:00
    reserved1stringnullable

    Legacy field, can be ignored

    reserved2numbernullable

    Legacy field, can be ignored

    reserved3numbernullable

    Legacy field, can be ignored

    rows object[]

    Array of entry rows with cells, notes, attachments, and locations.

    This is the main data structure that contains the actual entries of the sheet. The entries are organized into rows of "combos" (unique combinations of project/code/etc.), with each row containing individual cells for each date in the period.

    Performance Note: Including this field in a collection response is expensive and limited to 10 sheets per request. When using collections, you can explicitly request this with $keys=rows.

    See also the Entry Sheet API tutorial.

  • Array [
  • projectstringnullable

    Project ID for this row

    Example: p_d_1_1
    project_namestring

    Project display name

    Example: D.01.01 Delta Maine Portland
    code0stringnullable

    Activity/Task code

    Example: Meetings
    code0_namestring

    Activity/Task display name

    Example: Meetings
    code1stringnullable

    Pay type code (time) or expense type code

    Example: Regular
    code1_namestring

    Pay/expense type display name

    Example: Regular
    code2stringnullable

    Bill type code (time) or currency code (expense)

    Example: Standard
    code2_namestring

    Bill/currency type display name

    Example: Standard
    code3stringnullable

    Additional code column (if configured)

    code3_namestring

    Additional code display name

    code4stringnullable

    Additional code column (if configured)

    code4_namestring

    Additional code display name

    code5stringnullable

    Additional code column (if configured)

    code5_namestring

    Additional code display name

    code6stringnullable

    Additional code column (if configured)

    code6_namestring

    Additional code display name

    commentstring

    Text comment for this row

    Example: Team standup meeting
    totalnumber<float>required

    Sum of amounts across all cells in this row

    Example: 40
    read_onlyboolean

    Whether this row is read-only (e.g., submitted/approved entries)

    Example: false
    interim_submittedboolean

    Whether this row has been interim submitted

    Example: false
    interim_approvedboolean

    Whether this row has been interim approved

    Example: false
    id_suggestionstringnullable

    ID of the suggestion that generated this row (if any)

    Example: null
    suggestionobjectnullable

    Details about the suggestion that generated this row

    cells object[]required

    Array of cells (one per date in the period)

  • Array [
  • datestringrequired

    Date in F8 format (YYYYMMDD)

    Possible values: Value must match regular expression ^\d{8}$

    Example: 20251103
    amountnumber<float>required

    The entry amount for this cell:

    • For time: hours (e.g., 8.0)
    • For expense: monetary amount or mileage
    • For custom: distance
    Example: 8
    idsstring[]

    Array of entry record IDs that contribute to this cell's total. Multiple IDs indicate multiple entries for the same row/date combination.

    Example: ["time_rec_12345","time_rec_67890"]
    attachments object[]

    File attachments associated with this cell

  • Array [
  • uniqueidstringrequired

    Encoded unique identifier for the attachment. Used to retrieve or delete the attachment.

    This can be provided to the getAttachmentByEncodedId legacy API method to retrieve the file.

    Example: dGltZV9hdHRhY2htZW50czoxMjM0NQ==
    creatorstringrequired

    User ID of the person who uploaded the attachment

    Example: alice
    create_timestampnumber<double>required

    Unix timestamp when the attachment was uploaded

    Example: 1762196180
    notestring

    Optional description or note about the attachment

    Example: Receipt for client lunch meeting
    filenamestringrequired

    Original filename of the uploaded file

    Example: receipt_2025-11-03.pdf
    mimetypestring

    MIME type of the file

    Example: application/pdf
    sizeinteger

    File size in bytes

    Example: 524288
  • ]
  • notes object[]

    Diary notes associated with this cell

  • Array [
  • idstringrequired

    Unique identifier for the note

    Example: note_12345
    textstringrequired

    The note text content

    Example: Worked on bug fixes for the login module
    modifiedboolean

    Whether the note has been modified since creation

    Example: false
  • ]
  • locations object[]

    GPS locations recorded for entries in this cell

  • Array [
  • coords objectrequired

    Geographic coordinates

    latitudenumber<double>required

    Latitude in decimal degrees

    Example: 30.0613632
    longitudenumber<double>required

    Longitude in decimal degrees

    Example: -99.1363072
    altitudenumber<double>nullable

    Altitude in meters above sea level (when available).

    Example: null
    accuracynumber<float>

    Horizontal accuracy in meters. A geofence can have a minimum required accuracy, but different devices may have different capabilities.

    Example: 963.78847
    notesstring

    Additional notes or description for this location. This is only rarely provided / available.

    Example:
    timestampnumber<double>required

    Unix timestamp (milliseconds) when the location was captured

    Example: 1762542072875
  • ]
  • ]
  • punchlists object[]

    Punch-in/punch-out times for this row (time entries only with job start/stop). Job-based punches are attached to rows rather than individual dates.

  • Array [
  • punches object[]

    List of punch-in/punch-out pairs. (Each pair is a single object here.)

  • Array [
  • time_instringrequired

    Punch-in time in HH:MM format (24-hour)

    Example: 08:00
    time_in_unix_epochnumber<double>required

    Punch-in time as Unix timestamp

    Example: 1730894400
    time_in_ISO_8601string<date-time>required

    Punch-in time in ISO 8601 format

    Example: 2025-11-04T08:00:00-06:00
    time_in_location object

    Location captured at punch-in time (optional)

    coords objectrequired

    Geographic coordinates

    latitudenumber<double>required

    Latitude in decimal degrees

    Example: 30.0613632
    longitudenumber<double>required

    Longitude in decimal degrees

    Example: -99.1363072
    altitudenumber<double>nullable

    Altitude in meters above sea level (when available).

    Example: null
    accuracynumber<float>

    Horizontal accuracy in meters. A geofence can have a minimum required accuracy, but different devices may have different capabilities.

    Example: 963.78847
    notesstring

    Additional notes or description for this location. This is only rarely provided / available.

    Example:
    timestampnumber<double>required

    Unix timestamp (milliseconds) when the location was captured

    Example: 1762542072875
    time_outstringnullable

    Punch-out time in HH:MM format (24-hour). Null for open punches (not yet punched out).

    Example: 12:00
    time_out_unix_epochnumber<double>nullable

    Punch-out time as Unix timestamp

    Example: 1762279200
    time_out_ISO_8601string<date-time>nullable

    Punch-out time in ISO 8601 format

    Example: 2025-11-04T12:00:00-06:00
    time_out_location object

    Location captured at punch-out time (optional)

    coords objectrequired

    Geographic coordinates

    latitudenumber<double>required

    Latitude in decimal degrees

    Example: 30.0613632
    longitudenumber<double>required

    Longitude in decimal degrees

    Example: -99.1363072
    altitudenumber<double>nullable

    Altitude in meters above sea level (when available).

    Example: null
    accuracynumber<float>

    Horizontal accuracy in meters. A geofence can have a minimum required accuracy, but different devices may have different capabilities.

    Example: 963.78847
    notesstring

    Additional notes or description for this location. This is only rarely provided / available.

    Example:
    timestampnumber<double>required

    Unix timestamp (milliseconds) when the location was captured

    Example: 1762542072875
  • ]
  • ]
  • ]
  • columns object[]

    Metadata describing the available entry columns for this sheet. Defines what fields can be used (project, codes, comments, etc.). The columns are listed in the order (left-to-right) they appear on the entry screen.

  • Array [
  • column_idstringrequired

    Standard column identifier, also known as the "API name" for the column:

    • project - Project column
    • code0 through code6 - Code columns (task, pay type, bill type, etc.)
    • comment - Primary text comment
    • text2, text3 - Additional text fields
    • group - Group column - rarely used as an entry column.
    • user - User (for crew entry)
    Example: project
    column_alt_idstring

    Alternative/legacy column identifier, also known as the internal "jtgui name" for the column:

    • h1 - Project
    • dd1 through dd7 - Dropdown codes
    • tb1 through tb3 - Text boxes
    • grp1 - Group
    • u1 - User
    Example: h1
    namestringrequired

    The configurable display name (label) for the column.

    Example: Project
    tablestring

    Database table name for this column type. This table stores the primary selection values for this column.

    • projects - Projects
    • codes_tasks - Activity codes
    • codes_pay_types - Pay type codes
    • codes_bill_types - Bill type codes
    • Empty string for text columns
    Example: projects
    defaultstring

    Default value ID for this column

    Example: p_d_1_1
    default_namestring

    Display name of the default value

    Example: Customer XYZ: Implementation Phase
    priorityintegerrequired

    Display priority/order (higher = more important/displayed first)

    Example: 12
    hiddenboolean

    Whether this column is hidden from the user

    Example: false
    is_project_columnboolean

    True if this is the project column

    Example: true
    is_code_columnboolean

    True if this is a code/dropdown column (code0 through code6)

    Example: false
    is_text_columnboolean

    True if this is an open text entry column

    Example: false
  • ]
  • columns_dict object

    Dictionary version of columns array, keyed by column_id for easy lookup.

    property name* schemas-EntryColumn

    Metadata describing a configurable entry column (dimension) for the sheet. Columns define what fields are available for entry (project, task, pay type, etc.).

    column_idstringrequired

    Standard column identifier, also known as the "API name" for the column:

    • project - Project column
    • code0 through code6 - Code columns (task, pay type, bill type, etc.)
    • comment - Primary text comment
    • text2, text3 - Additional text fields
    • group - Group column - rarely used as an entry column.
    • user - User (for crew entry)
    Example: project
    column_alt_idstring

    Alternative/legacy column identifier, also known as the internal "jtgui name" for the column:

    • h1 - Project
    • dd1 through dd7 - Dropdown codes
    • tb1 through tb3 - Text boxes
    • grp1 - Group
    • u1 - User
    Example: h1
    namestringrequired

    The configurable display name (label) for the column.

    Example: Project
    tablestring

    Database table name for this column type. This table stores the primary selection values for this column.

    • projects - Projects
    • codes_tasks - Activity codes
    • codes_pay_types - Pay type codes
    • codes_bill_types - Bill type codes
    • Empty string for text columns
    Example: projects
    defaultstring

    Default value ID for this column

    Example: p_d_1_1
    default_namestring

    Display name of the default value

    Example: Customer XYZ: Implementation Phase
    priorityintegerrequired

    Display priority/order (higher = more important/displayed first)

    Example: 12
    hiddenboolean

    Whether this column is hidden from the user

    Example: false
    is_project_columnboolean

    True if this is the project column

    Example: true
    is_code_columnboolean

    True if this is a code/dropdown column (code0 through code6)

    Example: false
    is_text_columnboolean

    True if this is an open text entry column

    Example: false
    gui_optionsobject

    UI configuration options for the entry screen. Note: This is an internal-use field. Detailed documentation will be provided in a future release. Contains settings like time format, default values, display preferences, etc.

    Example: {"entryType":"time","timeformat":2,"arrows":1,"pname":"Multi Project Time Entry Grid"}
    approval_plan_info object

    Information about the approval workflow configuration for the sheet.

    approval_plan_activebooleanrequired

    Whether an approval plan is active for this sheet

    Example: true
    approval_levelsinteger

    Number of approval levels required

    Example: 2
    approver_idstringnullable

    User ID of the next approver in the workflow

    Example: marino
    approver_namestringnullable

    Full name of the next approver

    Example: Stephanie Marino
    audit_settings object

    Audit configuration controlling how corrections to submitted entries are handled.

    audit_level_settingstringrequired

    The audit level for this sheet, which primarily concerns whether correction records are generated, or the original records are simply modified in place.

    • auditlevel1: "Do not track changes" - never generate correction records.
    • auditlevel2: "Track changes after sheet submission" - generate correction records only after the sheet has been submitted for approval.
    • auditlevel3: "Require correction notes after sheet submission" - correction records must include a correction note.
    • auditlevel4: "Always track changes" - always generate correction records, even before sheet submission.
    • auditlevel5: "Always require correction notes" - correction records must include a correction note, even before sheet submission.

    Possible values: [auditlevel1, auditlevel2, auditlevel3, auditlevel4, auditlevel5]

    Example: auditlevel2
    has_ever_been_submittedinteger

    Whether this sheet has ever been submitted (0 or 1)

    Example: 0
    requires_correction_recsinteger

    Whether correction records are required for changes (0 or 1)

    Example: 0
    requires_new_entriesboolean

    Whether new entries require special handling

    Example: false
    id_approverstringnullable

    If the sheet has been approved, this is the User ID of the approving user. (Same as 'approver')

    Example: null
    approverstringnullable

    If the sheet has been approved, this is the User ID of the approving user. (Same as 'id_approver')

    Example: null
    approverViewboolean

    Whether the current user is viewing this as an approver

    Example: false
    reasonstringnullable

    Reason for rejection (if state is rejected)

    Example: null
    can_be_submittedboolean

    Whether the sheet can currently be submitted for approval

    Example: false
    can_be_interim_submittedboolean

    Whether partial (interim) submission is allowed

    Example: true
    can_go_pastboolean

    Whether the user can navigate to past periods

    Example: true
    can_go_futureboolean

    Whether the user can navigate to future periods

    Example: false
    min_datestringnullable

    Earliest allowed date for entries (F8 format). This mainly relates to the UI setting about allowing viewing past or future periods.

    Possible values: Value must match regular expression ^\d{8}$

    Example: null
    max_datestringnullable

    Latest allowed date for entries (F8 format). This mainly relates to the UI setting about allowing viewing past or future periods.

    Possible values: Value must match regular expression ^\d{8}$

    Example: 20251108
    confirm_submitboolean

    Whether to show confirmation dialog on submit

    Example: true
    confirmation_textstring

    Text to display in submission confirmation dialog

    Example: Are you sure you want to submit this sheet for approval?
    confirmation_warnings_textstring

    Text to display when submitting with warnings

    Example: Your time may violate entry rules specified by your organization, but can still be submitted for approval. Submit sheet with warnings?
    warningsboolean

    Whether the sheet currently has validation warnings

    Example: false
    location_enabledboolean

    Whether location tracking is enabled for this sheet type. This does not necessarily require location collection, but the system will record the user's location if provided. Note that geofences will always be enforced whenever location is provided, but you must separately enable the "Require Location" setting if you want to mandate that geofences are always checked.

    Example: false
    require_location_webboolean

    Whether location is required for web-based entries. If the user does not provide location, they will be unable to save changes to the sheet. Note that the "Submit for Approval" action does NOT check for location.

    Example: false
    require_location_mobileboolean

    Whether location is required using the mobile app. If the user does not provide location, they will be unable to save changes to the sheet. Note that the "Submit for Approval" action does NOT check for location.

    Example: false
    entry_notes_enabledboolean

    Whether entry notes (diary notes) are enabled. These are notes that can be attached to individual cells (row + date combinations).

    Example: true
    attachments_enabledboolean

    Whether file attachments are enabled for this sheet

    Example: true
    attachments_uploads_allowedboolean

    Whether the user is currently allowed to upload attachments. This can be false when either attachments are not enabled, or the maximum number of attachments has been reached.

    Example: false
    extended_fields_enabledboolean

    Whether the "Extended Fields" feature is enabled.

    Example: false
    id_user_properties object

    Full user record for the sheet owner, including custom fields. Contains all user attributes, roles, abilities, etc.

    idstring

    The internal ID of the resource or object. This is a 32-character hexadecimal string (UUID without hyphens).

    In general, the id field is the primary key of the object and cannot be changed or updated.

    Example: 64BBA147B9AC41D9978062300826C89F
    uristring<uri-reference>

    The URI associated with this resource. This is usually a relative URL that can be used to access the resource. Typically it incorporates the Unique ID of the resource.

    Example: /api/v1/objects/64BBA147B9AC41D9978062300826C89F
    tablenamestring

    The name of the internal database table associated with this resource.

    Example: users
    table_labelstring

    The user-visible label of the database table associated with this object.

    Example: codes_pay_types
    custom_fields object

    An object with Custom Fields for this record. The key is the field ID and the value a description of the field. Additional details here: CustomFields Schema

    tip

    Updating Custom Field values

    When creating or updating an existing object that uses Custom Fields, for example a User record, you can follow this custom_field key structure to update the custom field values. The value field is the only required field for updating a custom field value; other fields such as pname will be ignored.

    info

    Important: depending on the endpoint, this may only be included in the response if $keys=custom_fields or $keys=$extended was set as a query parameter.

    There is also a more compact representation available in most object types, where each custom field value is a separate key in the main object (not under custom_fields).

    See the CustomFields Schema page for more detailed information on these topics.

    property name* CustomFieldValue

    A specific instance (value) of a Custom field for a particular object.

    id_attr_typestring

    The unique internal ID of this Custom Field definition (same as id field)

    Example: 2DDD372DC4D3422D9E73F6DE936C4265
    attr_typestring

    Datatype of the custom field. The basic types available are:

    • STRING - a variable-length string.
    • CHAR - a fixed-length string. (The value may be padded with spaces.)
    • NUMBER - a floating-point number.
    • INTEGER - an integer (whole number).
    • TIMESTAMP - a date and time, stored in Unix epoch format.
    • DATE - a YYYYMMDD (F8) date.

    In addition, most types can be modified with a prefix to indicate whether they are "select lists" (ENUM or enumerated) or "multi-select lists" (M_ENUM) which can take on multiple values.

    Strings and char may also have a maximum length specified, such as STRING_100.

    Example: STRING_100
    descriptionstring

    Description of custom field

    pnamestring

    Name of custom field

    Example: Pay Group
    id_attr_type_uristring

    URI of the custom field to get more information about the custom field definition.

    Example: /api/v1/custom_fields/E07526A217164D1B94188279A8A0E4D9
    valuestring

    Value of the custom field for this object. To update the value, see the note on the CustomFields schema page.

    Note that when modifying Custom Fields of objects like Users or Projects, only the value key will be checked; other fields like the Custom Field pname will be ignored.

    Example: XYZ Pay Group
    group_names object[]

    A list of Groups (names and IDs) that the object belongs to.

    This is a read-only list. To change the Groups that an object belongs to, use the groups field.

    See GroupFields for additional information about Groups and this field.

  • Array [
  • idstring

    The Group ID (32-character hexadecimal string).

    pnamestring

    The Group name.

    uristring

    The URI of the Group.

    WARNING: this field is planned in a future release but is not yet available.

  • ]
  • groupsstring[]

    A list of Group IDs that the object belongs to. See GroupFields for additional information about Groups and this field.

    Example: ["5088C427E8B64EBEBE1C5B5961DB1902","3553F715A6F54DAB95D0D25B08468195"]
    is_hiddenboolean

    Indicates whether the object is hidden.

    See also status

    hiddenboolean

    Indicates whether the user is hidden.

    Read-only alias for is_hidden.

    statusstring

    The status of the user; either hidden, active, or inactive.

    Possible values: [Hidden, Loggable and Reportable, Reportable Only]

    Example: Loggable and Reportable
    status_codestring

    The internal code for the status of the object; either:

    • lr for Loggable and Reportable
    • ro for Reportable Only
    • h for Hidden

    Possible values: [lr, ro, h]

    Example: lr
    user_loginstringrequired

    The login name of the user.

    Example: john.smith@example.com
    fullnamestringrequired

    The full name of the user.

    Example: John Smith
    u_commentstring

    The default comment on the user's time entry screen.

    default_memorized_sheetstring

    The ID of the user's default memorized timesheet.

    dropdownthresholdinteger

    The number of items in a selection list to trigger a forced search.

    hideboolean

    Indicates whether the user is hidden.

    Note: the User object is the only one that uses this field; other objects use is_hidden.

    expire_new_pwboolean

    Whether the user's new password should expire after the first login.

    This is a write-only field that does not appear in User object responses.

    new_pwstring

    The new password for the user.

    The password must also be set in the new_pw2 field to confirm the change.

    This is a write-only field that does not appear in User object responses.

    new_pw2string

    The new password for the user, repeated to confirm the change.

    The password must also be set in the new_pw field to confirm the change.

    This is a write-only field that does not appear in User object responses.

    rolesstring[]

    A list of role IDs belonging to this user.

    This list can be modified to change the user's roles.

    timerecs_ininteger

    The number of blank rows to show on the entry screen.

    Example: 3
    time_periodstring

    The "Entry Screen period" (time-span) associated with the user's Time Entry screen.

    Example: default_weekly
    expense_periodstring

    The "Entry Screen period" (time-span) associated with the user's Expense Entry screen.

    Example: default_weekly
    custom_periodstring

    The "Entry Screen period" (time-span) associated with the user's Custom Entry screen.

    Example: default_weekly
    expense_guistring

    The ID of the user's assigned Expense entry screen configuration.

    time_guistring

    The ID of the user's assigned time entry screen configuration.

    travel_guistring

    The ID of the user's assigned Custom Entry (a.k.a. Mileage or Travel) entry screen configuration.

    creatorstring

    The internal User ID of the user who created the object.

    Example: 64BBA147B9AC41D9978062300826C89F
    creator_fullnamestring

    The full name of the user who created the object.

    Example: John Doe
    creator_propertiesobject

    Extended information about the User who created the object. This field is only included if the $keys parameter requests it.

    create_timestampnumber<float>

    The timestamp when the object was created, in Unix epoch format. This is the number of seconds since 1970-01-01T00:00:00Z.

    Example: 1696021987.01375
    create_timestamp_date_longstring

    The object creation date in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023
    create_timestamp_date_shortstring

    The object creation date in the "short date" format defined in the system settings.

    Example: 03/22/2023
    create_timestamp_datetime_longstring

    The object creation date and time in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023 12:18:46 CDT
    create_timestamp_datetime_shortstring

    The object creation date and time in the "short date" format defined in the system settings.

    Example: 03/22/2023 12:18:46 CDT
    create_timestamp_isostring<date-time>

    The creation timestamp in ISO 8601 format.

    Example: 2023-03-22T12:18:46-05:00
    modifierstring

    The internal User ID of the user who most recently modified the object.

    Example: 64BBA147B9AC41D9978062300826C89F
    modifier_fullnamestring

    The full name of the user who most recently modified the object.

    Example: John Doe
    modifier_propertiesobject

    Extended information about the User who last modified the object. This field is only included if the $keys parameter requests it.

    modify_timestampnumber<float>

    The timestamp when the object was most recently modified, in Unix epoch format. This is the number of seconds since 1970-01-01T00:00:00Z.

    Example: 1696021987.01375
    modify_timestamp_date_longstring

    The last modification date in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023
    modify_timestamp_date_shortstring

    The last modification date in the "short date" format defined in the system settings.

    Example: 03/22/2023
    modify_timestamp_datetime_longstring

    The last modification date and time in the "long date" format defined in the system settings.

    Example: Wednesday, March 22, 2023 12:18:46 CDT
    modify_timestamp_datetime_shortstring

    The last modification date and time in the "short date" format defined in the system settings.

    Example: 03/22/2023 12:18:46 CDT
    modify_timestamp_isostring<date-time>

    The last modification timestamp in ISO 8601 format.

    Example: 2023-03-22T12:18:46-05:00
    id_domainstring

    The internal Domain ID of the resource or object. In general, this field is deprecated and not in use and can be ignored.

    Example: install_root_dom
    daysinlistinteger

    UNUSED FIELD This is a legacy field that is no longer used.

    emailstring

    The email address of the user.

    Note: This is a read-only field. To change the user's email address, you must modify the users_attribs:users_email field, or custom_fields.users_email.value.

    first_namestring

    The first name of the user.

    Note: read-only; set via the fullname field.

    id_userstring

    The unique internal ID of this user. (Same as id.)

    Example: 5CD906A3941C463B9CC98F49DBCC25AA
    last_namestring

    The last name of the user.

    Note: read-only; set via the fullname field.

    memorized_sheet_choices object[]

    A list of memorized timesheets associated with the user.

    These are the choices available to set in the default_memorized_sheet field.

  • Array [
  • valuestring

    The internal ID of the memorized timesheet.

    textstring

    The name of the memorized timesheet.

  • ]
  • reserved1string

    UNUSED FIELD This is a legacy field that is no longer used.

    reserved2number<float>

    UNUSED FIELD This is a legacy field that is no longer used.

    reserved3number<float>

    UNUSED FIELD This is a legacy field that is no longer used.

    timerecs_outinteger

    UNUSED FIELD This is a legacy field that is no longer used.

    time_gui_propertiesobject

    Details about the user's assigned time entry screen configuration.

    travel_gui_propertiesobject

    Details about the user's assigned Custom Entry (a.k.a. Mileage or Travel) entry screen configuration.

    expense_gui_propertiesobject

    Details about the user's assigned Expense entry screen configuration.

    history_urlstring

    A URL to view sheet history. Note that this returns an HTML view, not a JSON API endpoint.

    Example: /jtcgi/approveprojects.pyc?showsystemstick=1&nav_key=sheet_history&history=0B04998DCD0E45DF9D0EC97EC926D281
    report_urlstring

    URL to view/print sheet report

    Example: /#/reports/output/sheet/BA72DE7FFB854DF2B815A22C2BAEBC32/0B04998DCD0E45DF9D0EC97EC926D281
    accruals object[]

    Time banks (accruals) showing available leave balances. Only present for time entry sheets.

  • Array [
  • id_timebankstringrequired

    Unique identifier for the time bank

    Example: 6D88483CFE774250B29CC61266392DBA
    pnamestringrequired

    Display name of the time bank

    Example: Vacation
    hours_leftnumber<float>required

    Remaining balance in hours

    Example: 16
    id_code_pay_typestring[]

    Pay type codes associated with this accrual

    Example: ["Vacation"]
    pay_types object[]

    Detailed information about associated pay types

  • Array [
  • id_code_pay_typestring
    namestring
  • ]
  • use_hard_thresholdboolean

    Whether a hard minimum balance threshold is enforced

    Example: true
    hard_thresholdnumber<float>

    Minimum balance that cannot be exceeded

    Example: 0
    hard_threshold_messagestring

    Message displayed when hard threshold applies

    Example: Minimum balance of 0.00 hours is enforced.
    use_warningboolean

    Whether a warning threshold is configured

    Example: true
    warning_thresholdnumber<float>

    Balance level that triggers a warning

    Example: 8
    warning_threshold_messagestring

    Message displayed when warning threshold is reached

    Example: A warning is given when the balance is less than or equal to 8.00 hours.
    warning_typestring

    Type of warning configuration

    Example: v2
    errorsstring[]

    Any errors related to this accrual

    Example: []
    warningsstring[]

    Any warnings related to this accrual

    Example: []
    creatorstring

    User who created this time bank

    modifierstring

    User who last modified this time bank

    create_timestampnumber<double>

    Unix timestamp of creation

    modify_timestampnumber<double>

    Unix timestamp of last modification

  • ]
  • allocation_exempt_subcodesstring[]

    List of pay type codes that are exempt from allocation requirements. For example, a Paid Time Off code. Used when time allocation/distribution is enforced.

    Example: []
    punchlists object[]

    Allocation-mode punch times organized by date. One punch list per date in the period. Only populated when allocation punch tracking is enabled.

    Performance Note: Including this field is expensive and limited to 10 sheets per request. Request explicitly with $keys=rows.

  • Array [
  • punches object[]

    List of punch-in/punch-out pairs. (Each pair is a single object here.)

  • Array [
  • time_instringrequired

    Punch-in time in HH:MM format (24-hour)

    Example: 08:00
    time_in_unix_epochnumber<double>required

    Punch-in time as Unix timestamp

    Example: 1730894400
    time_in_ISO_8601string<date-time>required

    Punch-in time in ISO 8601 format

    Example: 2025-11-04T08:00:00-06:00
    time_in_location object

    Location captured at punch-in time (optional)

    coords objectrequired

    Geographic coordinates

    latitudenumber<double>required

    Latitude in decimal degrees

    Example: 30.0613632
    longitudenumber<double>required

    Longitude in decimal degrees

    Example: -99.1363072
    altitudenumber<double>nullable

    Altitude in meters above sea level (when available).

    Example: null
    accuracynumber<float>

    Horizontal accuracy in meters. A geofence can have a minimum required accuracy, but different devices may have different capabilities.

    Example: 963.78847
    notesstring

    Additional notes or description for this location. This is only rarely provided / available.

    Example:
    timestampnumber<double>required

    Unix timestamp (milliseconds) when the location was captured

    Example: 1762542072875
    time_outstringnullable

    Punch-out time in HH:MM format (24-hour). Null for open punches (not yet punched out).

    Example: 12:00
    time_out_unix_epochnumber<double>nullable

    Punch-out time as Unix timestamp

    Example: 1762279200
    time_out_ISO_8601string<date-time>nullable

    Punch-out time in ISO 8601 format

    Example: 2025-11-04T12:00:00-06:00
    time_out_location object

    Location captured at punch-out time (optional)

    coords objectrequired

    Geographic coordinates

    latitudenumber<double>required

    Latitude in decimal degrees

    Example: 30.0613632
    longitudenumber<double>required

    Longitude in decimal degrees

    Example: -99.1363072
    altitudenumber<double>nullable

    Altitude in meters above sea level (when available).

    Example: null
    accuracynumber<float>

    Horizontal accuracy in meters. A geofence can have a minimum required accuracy, but different devices may have different capabilities.

    Example: 963.78847
    notesstring

    Additional notes or description for this location. This is only rarely provided / available.

    Example:
    timestampnumber<double>required

    Unix timestamp (milliseconds) when the location was captured

    Example: 1762542072875
  • ]
  • ]
  • successboolean

    Indicates whether the request was successful (normally true if it's not an error response)

    Default value: true
    uristring<uri-reference>

    URL of the current request / resource, for reference purposes.

    Example: https://example.apps.journyx.com/api/v1/users
    TimeSheetItemResponse
    {
    "response_code": 200,
    "results": {
    "id": "64BBA147B9AC41D9978062300826C89F",
    "uri": "/api/v1/objects/64BBA147B9AC41D9978062300826C89F",
    "tablename": "users",
    "table_label": "codes_pay_types",
    "creator": "64BBA147B9AC41D9978062300826C89F",
    "creator_fullname": "John Doe",
    "creator_properties": {
    "id": "64BBA147B9AC41D9978062300826C89F",
    "uri": "/api/v1/objects/64BBA147B9AC41D9978062300826C89F",
    "tablename": "users",
    "table_label": "codes_pay_types",
    "custom_fields": {
    "C41B2DDA662F4EF6B730F9CB6DB04696": {
    "attr_type": "ENUM_STRING_252",
    "description": "Employee pay group.",
    "id_attr_type": "C41B2DDA662F4EF6B730F9CB6DB04696",
    "id_attr_type_uri": "/api/v1/custom_fields/C41B2DDA662F4EF6B730F9CB6DB04696",
    "pname": "Pay Group",
    "value": "XYZ Pay Group"
    },
    "users_email": {
    "attr_type": "STRING_252",
    "description": "Email address",
    "id_attr_type": "users_email",
    "id_attr_type_uri": "/api/v1/custom_fields/users_email",
    "pname": "Email Address",
    "value": "username@example.com"
    }
    },
    "group_names": [
    {
    "id": "5088C427E8B64EBEBE1C5B5961DB1902",
    "pname": "Sales"
    },
    {
    "id": "3553F715A6F54DAB95D0D25B08468195",
    "pname": "Accounting"
    },
    {
    "id": "5088C427E8B64EBEBE1C5B5961DB1902",
    "pname": "Sales"
    },
    {
    "id": "3553F715A6F54DAB95D0D25B08468195",
    "pname": "Accounting"
    }
    ],
    "groups": [
    "5088C427E8B64EBEBE1C5B5961DB1902",
    "3553F715A6F54DAB95D0D25B08468195",
    "5088C427E8B64EBEBE1C5B5961DB1902",
    "3553F715A6F54DAB95D0D25B08468195"
    ],
    "is_hidden": true,
    "hidden": true,
    "status": "Loggable and Reportable",
    "status_code": "lr",
    "user_login": "john.smith@example.com",
    "fullname": "John Smith",
    "u_comment": "string",
    "default_memorized_sheet": "string",
    "dropdownthreshold": 0,
    "hide": true,
    "expire_new_pw": true,
    "new_pw": "string",
    "new_pw2": "string",
    "roles": [
    "string"
    ],
    "timerecs_in": 3,
    "time_period": "default_weekly",
    "expense_period": "default_weekly",
    "custom_period": "default_weekly",
    "expense_gui": "string",
    "time_gui": "string",
    "travel_gui": "string",
    "create_timestamp": 1696021987.01375,
    "create_timestamp_date_long": "Wednesday, March 22, 2023",
    "create_timestamp_date_short": "03/22/2023",
    "create_timestamp_datetime_long": "Wednesday, March 22, 2023 12:18:46 CDT",
    "create_timestamp_datetime_short": "03/22/2023 12:18:46 CDT",
    "create_timestamp_iso": "2023-03-22T12:18:46-05:00",
    "modifier": "64BBA147B9AC41D9978062300826C89F",
    "modifier_fullname": "John Doe",
    "modifier_properties": {},
    "modify_timestamp": 1696021987.01375,
    "modify_timestamp_date_long": "Wednesday, March 22, 2023",
    "modify_timestamp_date_short": "03/22/2023",
    "modify_timestamp_datetime_long": "Wednesday, March 22, 2023 12:18:46 CDT",
    "modify_timestamp_datetime_short": "03/22/2023 12:18:46 CDT",
    "modify_timestamp_iso": "2023-03-22T12:18:46-05:00",
    "id_domain": "install_root_dom",
    "daysinlist": 0,
    "email": "string",
    "first_name": "string",
    "id_user": "5CD906A3941C463B9CC98F49DBCC25AA",
    "last_name": "string",
    "memorized_sheet_choices": [
    {
    "value": "string",
    "text": "string"
    }
    ],
    "reserved1": "string",
    "reserved2": 0,
    "reserved3": 0,
    "timerecs_out": 0,
    "time_gui_properties": {},
    "travel_gui_properties": {},
    "expense_gui_properties": {},
    "creator": "64BBA147B9AC41D9978062300826C89F",
    "creator_fullname": "John Doe",
    "creator_properties": {}
    },
    "create_timestamp": 1696021987.01375,
    "create_timestamp_date_long": "Wednesday, March 22, 2023",
    "create_timestamp_date_short": "03/22/2023",
    "create_timestamp_datetime_long": "Wednesday, March 22, 2023 12:18:46 CDT",
    "create_timestamp_datetime_short": "03/22/2023 12:18:46 CDT",
    "create_timestamp_iso": "2023-03-22T12:18:46-05:00",
    "modifier": "64BBA147B9AC41D9978062300826C89F",
    "modifier_fullname": "John Doe",
    "modifier_properties": {
    "id": "64BBA147B9AC41D9978062300826C89F",
    "uri": "/api/v1/objects/64BBA147B9AC41D9978062300826C89F",
    "tablename": "users",
    "table_label": "codes_pay_types",
    "custom_fields": {
    "C41B2DDA662F4EF6B730F9CB6DB04696": {
    "attr_type": "ENUM_STRING_252",
    "description": "Employee pay group.",
    "id_attr_type": "C41B2DDA662F4EF6B730F9CB6DB04696",
    "id_attr_type_uri": "/api/v1/custom_fields/C41B2DDA662F4EF6B730F9CB6DB04696",
    "pname": "Pay Group",
    "value": "XYZ Pay Group"
    },
    "users_email": {
    "attr_type": "STRING_252",
    "description": "Email address",
    "id_attr_type": "users_email",
    "id_attr_type_uri": "/api/v1/custom_fields/users_email",
    "pname": "Email Address",
    "value": "username@example.com"
    }
    },
    "group_names": [
    {
    "id": "5088C427E8B64EBEBE1C5B5961DB1902",
    "pname": "Sales"
    },
    {
    "id": "3553F715A6F54DAB95D0D25B08468195",
    "pname": "Accounting"
    },
    {
    "id": "5088C427E8B64EBEBE1C5B5961DB1902",
    "pname": "Sales"
    },
    {
    "id": "3553F715A6F54DAB95D0D25B08468195",
    "pname": "Accounting"
    }
    ],
    "groups": [
    "5088C427E8B64EBEBE1C5B5961DB1902",
    "3553F715A6F54DAB95D0D25B08468195",
    "5088C427E8B64EBEBE1C5B5961DB1902",
    "3553F715A6F54DAB95D0D25B08468195"
    ],
    "is_hidden": true,
    "hidden": true,
    "status": "Loggable and Reportable",
    "status_code": "lr",
    "user_login": "john.smith@example.com",
    "fullname": "John Smith",
    "u_comment": "string",
    "default_memorized_sheet": "string",
    "dropdownthreshold": 0,
    "hide": true,
    "expire_new_pw": true,
    "new_pw": "string",
    "new_pw2": "string",
    "roles": [
    "string"
    ],
    "timerecs_in": 3,
    "time_period": "default_weekly",
    "expense_period": "default_weekly",
    "custom_period": "default_weekly",
    "expense_gui": "string",
    "time_gui": "string",
    "travel_gui": "string",
    "creator": "64BBA147B9AC41D9978062300826C89F",
    "creator_fullname": "John Doe",
    "creator_properties": {},
    "create_timestamp": 1696021987.01375,
    "create_timestamp_date_long": "Wednesday, March 22, 2023",
    "create_timestamp_date_short": "03/22/2023",
    "create_timestamp_datetime_long": "Wednesday, March 22, 2023 12:18:46 CDT",
    "create_timestamp_datetime_short": "03/22/2023 12:18:46 CDT",
    "create_timestamp_iso": "2023-03-22T12:18:46-05:00",
    "modify_timestamp": 1696021987.01375,
    "modify_timestamp_date_long": "Wednesday, March 22, 2023",
    "modify_timestamp_date_short": "03/22/2023",
    "modify_timestamp_datetime_long": "Wednesday, March 22, 2023 12:18:46 CDT",
    "modify_timestamp_datetime_short": "03/22/2023 12:18:46 CDT",
    "modify_timestamp_iso": "2023-03-22T12:18:46-05:00",
    "id_domain": "install_root_dom",
    "daysinlist": 0,
    "email": "string",
    "first_name": "string",
    "id_user": "5CD906A3941C463B9CC98F49DBCC25AA",
    "last_name": "string",
    "memorized_sheet_choices": [
    {
    "value": "string",
    "text": "string"
    }
    ],
    "reserved1": "string",
    "reserved2": 0,
    "reserved3": 0,
    "timerecs_out": 0,
    "time_gui_properties": {},
    "travel_gui_properties": {},
    "expense_gui_properties": {},
    "modifier": "64BBA147B9AC41D9978062300826C89F",
    "modifier_fullname": "John Doe",
    "modifier_properties": {}
    },
    "modify_timestamp": 1696021987.01375,
    "modify_timestamp_date_long": "Wednesday, March 22, 2023",
    "modify_timestamp_date_short": "03/22/2023",
    "modify_timestamp_datetime_long": "Wednesday, March 22, 2023 12:18:46 CDT",
    "modify_timestamp_datetime_short": "03/22/2023 12:18:46 CDT",
    "modify_timestamp_iso": "2023-03-22T12:18:46-05:00",
    "id_sheet": "0B04998DCD0E45DF9D0EC97EC926D281",
    "id_user": "alice",
    "user": "alice",
    "user_login": "alice@company.com",
    "user_name": "Alice Dev",
    "id_timesheet": "default_weekly",
    "type": "time",
    "state": "open",
    "state_flag": 0,
    "start_date": "20251102",
    "end_date": "20251108",
    "dates": [
    "20251102",
    "20251103",
    "20251104",
    "20251105",
    "20251106",
    "20251107",
    "20251108"
    ],
    "rod": "20251102202511032025110420251105202511062025110720251108",
    "total": 40,
    "entry_count": 5,
    "level": 0,
    "interim_sheet": false,
    "sheet_table": "user_time_sheets",
    "sheet_status": "Open for Entry",
    "pname": "11/02/2025 - 11/08/2025",
    "modified_at": "2025-11-03T12:56:20-06:00",
    "reserved1": "string",
    "reserved2": 0,
    "reserved3": 0,
    "rows": [
    {
    "project": "p_d_1_1",
    "project_name": "D.01.01 Delta Maine Portland",
    "code0": "Meetings",
    "code0_name": "Meetings",
    "code1": "Regular",
    "code1_name": "Regular",
    "code2": "Standard",
    "code2_name": "Standard",
    "code3": "string",
    "code3_name": "string",
    "code4": "string",
    "code4_name": "string",
    "code5": "string",
    "code5_name": "string",
    "code6": "string",
    "code6_name": "string",
    "comment": "Team standup meeting",
    "total": 40,
    "read_only": false,
    "interim_submitted": false,
    "interim_approved": false,
    "id_suggestion": null,
    "suggestion": {},
    "cells": [
    {
    "date": "20251103",
    "amount": 8,
    "ids": [
    "time_rec_12345",
    "time_rec_67890"
    ],
    "attachments": [
    {
    "uniqueid": "dGltZV9hdHRhY2htZW50czoxMjM0NQ==",
    "creator": "alice",
    "create_timestamp": 1762196180,
    "note": "Receipt for client lunch meeting",
    "filename": "receipt_2025-11-03.pdf",
    "mimetype": "application/pdf",
    "size": 524288
    }
    ],
    "notes": [
    {
    "id": "note_12345",
    "text": "Worked on bug fixes for the login module",
    "modified": false
    }
    ],
    "locations": [
    {
    "coords": {
    "latitude": 30.0613632,
    "longitude": -99.1363072,
    "altitude": null,
    "accuracy": 963.78847
    },
    "notes": "",
    "timestamp": 1762542072875
    }
    ]
    }
    ],
    "punchlists": [
    {
    "punches": [
    {
    "time_in": "08:00",
    "time_in_unix_epoch": 1730894400,
    "time_in_ISO_8601": "2025-11-04T08:00:00-06:00",
    "time_in_location": {
    "coords": {
    "latitude": 30.0613632,
    "longitude": -99.1363072,
    "altitude": null,
    "accuracy": 963.78847
    },
    "notes": "",
    "timestamp": 1762542072875
    },
    "time_out": "12:00",
    "time_out_unix_epoch": 1762279200,
    "time_out_ISO_8601": "2025-11-04T12:00:00-06:00",
    "time_out_location": {
    "coords": {
    "latitude": 30.0613632,
    "longitude": -99.1363072,
    "altitude": null,
    "accuracy": 963.78847
    },
    "notes": "",
    "timestamp": 1762542072875
    }
    }
    ]
    }
    ]
    }
    ],
    "columns": [
    {
    "column_id": "project",
    "column_alt_id": "h1",
    "name": "Project",
    "table": "projects",
    "default": "p_d_1_1",
    "default_name": "Customer XYZ: Implementation Phase",
    "priority": 12,
    "hidden": false,
    "is_project_column": true,
    "is_code_column": false,
    "is_text_column": false
    }
    ],
    "columns_dict": {},
    "gui_options": {
    "entryType": "time",
    "timeformat": 2,
    "arrows": 1,
    "pname": "Multi Project Time Entry Grid"
    },
    "approval_plan_info": {
    "approval_plan_active": true,
    "approval_levels": 2,
    "approver_id": "marino",
    "approver_name": "Stephanie Marino"
    },
    "audit_settings": {
    "audit_level_setting": "auditlevel2",
    "has_ever_been_submitted": 0,
    "requires_correction_recs": 0,
    "requires_new_entries": false
    },
    "id_approver": null,
    "approver": null,
    "approverView": false,
    "reason": null,
    "can_be_submitted": false,
    "can_be_interim_submitted": true,
    "can_go_past": true,
    "can_go_future": false,
    "min_date": null,
    "max_date": "20251108",
    "confirm_submit": true,
    "confirmation_text": "Are you sure you want to submit this sheet for approval?",
    "confirmation_warnings_text": "Your time may violate entry rules specified by your organization, but can still be submitted for approval. Submit sheet with warnings?",
    "warnings": false,
    "location_enabled": false,
    "require_location_web": false,
    "require_location_mobile": false,
    "entry_notes_enabled": true,
    "attachments_enabled": true,
    "attachments_uploads_allowed": false,
    "extended_fields_enabled": false,
    "id_user_properties": {
    "id": "64BBA147B9AC41D9978062300826C89F",
    "uri": "/api/v1/objects/64BBA147B9AC41D9978062300826C89F",
    "tablename": "users",
    "table_label": "codes_pay_types",
    "custom_fields": {
    "C41B2DDA662F4EF6B730F9CB6DB04696": {
    "attr_type": "ENUM_STRING_252",
    "description": "Employee pay group.",
    "id_attr_type": "C41B2DDA662F4EF6B730F9CB6DB04696",
    "id_attr_type_uri": "/api/v1/custom_fields/C41B2DDA662F4EF6B730F9CB6DB04696",
    "pname": "Pay Group",
    "value": "XYZ Pay Group"
    },
    "users_email": {
    "attr_type": "STRING_252",
    "description": "Email address",
    "id_attr_type": "users_email",
    "id_attr_type_uri": "/api/v1/custom_fields/users_email",
    "pname": "Email Address",
    "value": "username@example.com"
    }
    },
    "group_names": [
    {
    "id": "5088C427E8B64EBEBE1C5B5961DB1902",
    "pname": "Sales"
    },
    {
    "id": "3553F715A6F54DAB95D0D25B08468195",
    "pname": "Accounting"
    }
    ],
    "groups": [
    "5088C427E8B64EBEBE1C5B5961DB1902",
    "3553F715A6F54DAB95D0D25B08468195"
    ],
    "is_hidden": true,
    "hidden": true,
    "status": "Loggable and Reportable",
    "status_code": "lr",
    "user_login": "john.smith@example.com",
    "fullname": "John Smith",
    "u_comment": "string",
    "default_memorized_sheet": "string",
    "dropdownthreshold": 0,
    "hide": true,
    "expire_new_pw": true,
    "new_pw": "string",
    "new_pw2": "string",
    "roles": [
    "string"
    ],
    "timerecs_in": 3,
    "time_period": "default_weekly",
    "expense_period": "default_weekly",
    "custom_period": "default_weekly",
    "expense_gui": "string",
    "time_gui": "string",
    "travel_gui": "string",
    "creator": "64BBA147B9AC41D9978062300826C89F",
    "creator_fullname": "John Doe",
    "creator_properties": {},
    "create_timestamp": 1696021987.01375,
    "create_timestamp_date_long": "Wednesday, March 22, 2023",
    "create_timestamp_date_short": "03/22/2023",
    "create_timestamp_datetime_long": "Wednesday, March 22, 2023 12:18:46 CDT",
    "create_timestamp_datetime_short": "03/22/2023 12:18:46 CDT",
    "create_timestamp_iso": "2023-03-22T12:18:46-05:00",
    "modifier": "64BBA147B9AC41D9978062300826C89F",
    "modifier_fullname": "John Doe",
    "modifier_properties": {},
    "modify_timestamp": 1696021987.01375,
    "modify_timestamp_date_long": "Wednesday, March 22, 2023",
    "modify_timestamp_date_short": "03/22/2023",
    "modify_timestamp_datetime_long": "Wednesday, March 22, 2023 12:18:46 CDT",
    "modify_timestamp_datetime_short": "03/22/2023 12:18:46 CDT",
    "modify_timestamp_iso": "2023-03-22T12:18:46-05:00",
    "id_domain": "install_root_dom",
    "daysinlist": 0,
    "email": "string",
    "first_name": "string",
    "id_user": "5CD906A3941C463B9CC98F49DBCC25AA",
    "last_name": "string",
    "memorized_sheet_choices": [
    {
    "value": "string",
    "text": "string"
    }
    ],
    "reserved1": "string",
    "reserved2": 0,
    "reserved3": 0,
    "timerecs_out": 0,
    "time_gui_properties": {},
    "travel_gui_properties": {},
    "expense_gui_properties": {}
    },
    "history_url": "/jtcgi/approveprojects.pyc?showsystemstick=1&nav_key=sheet_history&history=0B04998DCD0E45DF9D0EC97EC926D281",
    "report_url": "/#/reports/output/sheet/BA72DE7FFB854DF2B815A22C2BAEBC32/0B04998DCD0E45DF9D0EC97EC926D281",
    "accruals": [
    {
    "id_timebank": "6D88483CFE774250B29CC61266392DBA",
    "pname": "Vacation",
    "hours_left": 16,
    "id_code_pay_type": [
    "Vacation"
    ],
    "pay_types": [
    {
    "id_code_pay_type": "string",
    "name": "string"
    }
    ],
    "use_hard_threshold": true,
    "hard_threshold": 0,
    "hard_threshold_message": "Minimum balance of 0.00 hours is enforced.",
    "use_warning": true,
    "warning_threshold": 8,
    "warning_threshold_message": "A warning is given when the balance is less than or equal to 8.00 hours.",
    "warning_type": "v2",
    "errors": [],
    "warnings": [],
    "creator": "string",
    "modifier": "string",
    "create_timestamp": 0,
    "modify_timestamp": 0
    }
    ],
    "allocation_exempt_subcodes": [],
    "punchlists": [
    {
    "punches": [
    {
    "time_in": "08:00",
    "time_in_unix_epoch": 1730894400,
    "time_in_ISO_8601": "2025-11-04T08:00:00-06:00",
    "time_in_location": {
    "coords": {
    "latitude": 30.0613632,
    "longitude": -99.1363072,
    "altitude": null,
    "accuracy": 963.78847
    },
    "notes": "",
    "timestamp": 1762542072875
    },
    "time_out": "12:00",
    "time_out_unix_epoch": 1762279200,
    "time_out_ISO_8601": "2025-11-04T12:00:00-06:00",
    "time_out_location": {
    "coords": {
    "latitude": 30.0613632,
    "longitude": -99.1363072,
    "altitude": null,
    "accuracy": 963.78847
    },
    "notes": "",
    "timestamp": 1762542072875
    }
    }
    ]
    }
    ]
    },
    "success": true,
    "uri": "https://example.apps.journyx.com/api/v1/users"
    }