Skip to main content

jxAPI Types Reference

Warning: legacy API

This page is about the legacy SOAP-based jxAPI that is no longer updated or recommended for use in new projects. The documentation in this section may be outdated or inaccurate, and is provided for reference purposes only.

Journyx recommends using the REST-based API for new projects in most cases. However, at the current time, there are certain object types that are not available through the REST API.

AccessControlList

The following basic CRUD methods are available for this type:

FieldTypeDescription
vid_objectstring
acl_typedouble
id_groupstring

Accrual

An accrual.

The following basic CRUD methods are available for this type:

FieldTypeDescription
idstringThe ID of this accrual (primary key).
id_userstringThe ID of the user this accrual applies to.
id_code_pay_typestringID of the pay type this accrual applies to.
warning_typestringShould be 'v2'. Other types may exist before migration.
hours_leftdoubleHow many hours are left in this accrual.
id_domainstring
hard_thresholddoubleThreshold for hard cutoff.
warning_thresholddoubleThreshold for a soft warning.
creatorstringID of the user that created this accrual.
create_timestampdoubleTime stamp of when this accrual was created.
modifierstringID of the user that last modified this accrual.
modify_timestampdoubleTime stamp of when this accrual was last modified.
pnamestringDisplayed name of this accrual.
is_hiddenintNon-zero if this accrual is hidden.
use_warningintNon-zero if the soft warning threshold is to be used.
use_hard_thresholdintNon-zero if the hard threshold is to be used.

AccrualEvent

An accrual log event.

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_timebank_eventintThe ID of this event record.
id_timebankstringThe ID of the associated accrual.
event_codestringThe type of this event.
timestampdoubleThe time at which the event was logged.
ownerstringThe owner of the accrual.
modify_userstringThe user that caused this accrual event.
rulestringA short description of the event
notestringA free-form description or comment.
id_code_pay_typestringThe pay type of the associated accrual.
prev_hours_leftdoubleThe previous hours left in the accrual.
new_hours_leftdoubleThe new hours left in the accrual.
hours_left_diffdoubleThe difference in accrual hours left.
id_time_recstringThe ID of the associated time record.
vid_timesheetstringThe ID of the associated time sheet.
prev_id_code_liststringThe previous code list.
new_id_code_liststringThe new code list.
prev_hard_thresholddoubleThe previous hard accrual threshold.
new_hard_thresholddoubleThe new hard accrual threshold.
prev_warning_thresholddoubleThe previous warning threshold.
new_warning_thresholddoubleThe new warning threshold.
prev_pnamestringThe previous printable name of the accrual.
new_pnamestringThe new printable name of the accrual.
prev_is_hiddenintThe previous 'hidden' state of the accrual.
new_is_hiddenintThe new 'hidden' state of the accrual.
prev_use_warningintThe previous 'use warning' state of the accrual.
new_use_warningintThe new 'use warning' state of the accrual.
prev_use_hard_thresholdintThe previous 'use hard threshold' state of the accrual.
new_use_hard_thresholdintThe new 'use hard threshold' state of the accrual.
record_datestringThe YYYYMMDD date of the associated time record.

AccrualRecord

An accrued time balance.

FieldTypeDescription
idstringThe accrual ID.
codestringThe code (pay type) ID of this accrual.
typestringOne of 'Hard', 'Soft', or 'Hidden'.
hoursdoubleThe accrual balance.

AllColumnRecords

Container for lists of full project and code records, used by methods that do bulk data retrieval.

  • This type is not available in the following endpoints: zsi
FieldTypeDescription
projectslist of ProjectRecord
projects_extralist of ProjectExtra
mileage_vehicleslist of MileageVehicleRecord
codes_bill_typeslist of SubsubcodeRecord
codes_expenseslist of ExpenseCodeRecord
codes_pay_typeslist of SubcodeRecord
mileage_reasonslist of MileageReasonRecord
mileage_measurementslist of MileageMeasurementRecord
codes_taskslist of CodeRecord
codes_currencieslist of ExpenseCurrencyRecord
codes_expense_sourceslist of ExpenseSourceRecord
codes_time_4list of CodesTime4Record
codes_time_5list of CodesTime5Record
codes_time_6list of CodesTime6Record
codes_time_7list of CodesTime7Record
codes_expense_4list of CodesExpense4Record
codes_expense_5list of CodesExpense5Record
codes_expense_6list of CodesExpense6Record
codes_expense_7list of CodesExpense7Record
codes_custom_4list of CodesCustom4Record
codes_custom_5list of CodesCustom5Record
codes_custom_6list of CodesCustom6Record
codes_custom_7list of CodesCustom7Record

ApprovalObject

An approval plan.

FieldTypeDescription
apprtypestring
idstringThe ID of this approval plan.
namestringThe displayed name of this approval plan.
userbeforeintNumber of days before end of period to send a reminder email.
userafterintNumber of days after end of period to send a reminder email about a non-submitted sheet.
approverafterintNumber of days after end of period to remind approver about un-approved sheets.
approversubmittedintText to send to the approver when they have a sheet in queue.
backupafterintNumber of days after end of period to notify backup approvers of un-approved sheets.
userrejectedintText to send to a user when their sheet is rejected.
userapprovedintText to send to a user when their sheet is approved.
bizidstringThe business process ID of this approval plan. Usually default[1-5] for 1 to 5 approvers.
typestringThe plan type: 'time', 'expense', or 'mileage'.
approver_1stringThe user ID of the first approver.
approver_2stringThe user ID of the second approver.
approver_3stringThe user ID of the third approver.
approver_4stringThe user ID of the fourth approver.
approver_5stringThe user ID of the fifth approver.
backup_approver_1stringThe user ID of the first backup approver.
backup_approver_2stringThe user ID of the second backup approver.
backup_approver_3stringThe user ID of the third backup approver.
backup_approver_4stringThe user ID of the fourth backup approver.
backup_approver_5stringThe user ID of the fifth backup approver.
userbeforesubjectstring
userbeforebodystring
useraftersubjectstring
approveraftersubjectstring
approverafterbodystring
userrejectedsubjectstring
userrejectedbodystring
userapprovedsubjectstring
userapprovedbodystring
backupaftersubjectstring
backupafterbodystring
backupafterqueuestring
approversubmittedsubjectstring
approversubmittedbodystring
approverresubmittedint
approverresubmittedsubjectstring
approverresubmittedbodystring
appendtoemaillogint
appendtosheetnotesint
sendonweekendsint

AssignmentRecord

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

FieldTypeDescription
id_assignmentstring
pnamestring
id_projectstring
id_userstring
id_rolestring
id_groupstring
stateint
utilizationdouble
msp_assignment_idstring
msp_file_idstring
daily_loaddouble
work_variancedouble
start_variancedouble
end_variancedouble
duration_variancedouble
scheduled_workdouble
scheduled_startdouble
scheduled_enddouble
scheduled_durationdouble
actual_workdouble
actual_work_updateddouble
actual_startdouble
actual_enddouble
actual_durationdouble
estimated_workdouble
estimated_work1double
estimated_work2double
id_requisitionstring
is_manageddoublenew in v11.2
id_teamstring

Attachment

An attachment and its metadata.

FieldTypeDescription
recidstringThe ID of the record this item is attached to.
uniqueidstringThe unique ID of the attachment.
parent_tablestringThe name of the table the target record is in.
creatorstringThe ID of the user who created this attachment.
creator_namestringThe full name of the user who created this attachment.
creator_loginstringThe login name of the user who created this attachment.
create_timestampdoubleThe timestamp of when this attachment was created, in seconds since epoch.
create_timestringThe time when this attachment was created, as a human readable string.
notestringThe description/note of the attachment.
filenamestringThe original filename of the attachment.
mimetypestringThe MIME type of the attachment.
sizeintThe size of the attachment.
size_strstringThe size of the attachment as a human readable string.
sha256stringThe SHA256 hash of the attachment file data.
attachmentstringThe attachment file data, as base64.

AttributeQueryResult

A result from a custom field query.

FieldTypeDescription
object_idstringThe ID of the object this custom field value belongs to.
attrtype_idstringThe ID of the custom field type describing the field.
attr_pnamestringThe displayable name of the custom field.
valuestringThe field value. Always a string even if the underlying result is numeric.

AttributeTypeRecord

A custom field definition (not its actual value, but the metadata about the field itself.)

FieldTypeDescription
id_attr_typestringThe ID of this custom field.
table_namestringThe name of the table this custom field is on.
pnamestringThe displayed name of this custom field.
descriptionstringThe description of this custom field.
attr_typestringThe type of this custom field.
visibilityintVisibility in web UI: 0=hidden, 1=editable, 2=read-only
id_domainstringThe domain this custom field is in, if any.
hidden_namestringA read-only, hidden extra name for the field, usually equal to pname.
string_defaultstringThe default value for this custom field, for STRING/CHAR/DATE types.
numeric_defaultdoubleThe default value for this custom field, for NUMBER/INTEGER/TIMESTAMP types.

AttributeValue

FieldTypeDescription
namestring
valuestring

CellNote

FieldTypeDescription
idstringA unique ID for this note.
modifiedbooleanSet to True if you have modified this note.
correctionbooleanTrue if this is a correction (audit level required) note.
textstringThe note text.

CodeRecord

An item in the "tasks" column (or its renamed equivalent) of time records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

CodesCustom4Record

An item in the "Custom Entry Field 4" column (or its renamed equivalent) of custom entry records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

CodesCustom5Record

An item in the "Custom Entry Field 5" column (or its renamed equivalent) of custom entry records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

CodesCustom6Record

An item in the "Custom Entry Field 6" column (or its renamed equivalent) of custom entry records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

CodesCustom7Record

An item in the "Custom Entry Field 7" column (or its renamed equivalent) of custom entry records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

CodesExpense4Record

An item in the "Expense Entry Field 4" column (or its renamed equivalent) of expense records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

CodesExpense5Record

An item in the "Expense Entry Field 5" column (or its renamed equivalent) of expense records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

CodesExpense6Record

An item in the "Expense Entry Field 6" column (or its renamed equivalent) of expense records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

CodesExpense7Record

An item in the "Expense Entry Field 7" column (or its renamed equivalent) of expense records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

CodesTime4Record

An item in the "Time Entry Field 4" column (or its renamed equivalent) of time records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

CodesTime5Record

An item in the "Time Entry Field 5" column (or its renamed equivalent) of time records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

CodesTime6Record

An item in the "Time Entry Field 6" column (or its renamed equivalent) of time records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

CodesTime7Record

An item in the "Time Entry Field 7" column (or its renamed equivalent) of time records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
creatorstringThe ID of the user that created this item.
create_timestampstringThe time this item was created.
modifierstringThe ID of the user that last modified this item.
modify_timestampstringThe time this item was last modified.

ColumnDependency

A column-to-column dependency.

FieldTypeDescription
parent_tablestringThe parent table name.
parent_idstringThe parent record ID.
child_tablestringThe child table name.
child_idstringThe child record ID.

CurrencyConversion

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_currency_conversionstring
start_datestring
stop_datestring
id_domainstring
convert_fromstring
convert_tostring
convert_factorstring

DisplaySettings

Server-configurable settings related to displaying time/expense/custom entry screens.

  • This type is not available in the following endpoints: zsi
FieldTypeDescription
time_labelstringThe label of the time entry table.
time_column_nameslist of stringThe names of the time entry columns (project, 3 codes, comment).
time_column_prioritylist of intThe ordering of the time entry columns.
expense_labelstringThe label of the expense entry table.
expense_column_nameslist of stringThe names of the expense entry columns (project, 3 codes, comment).
expense_column_prioritylist of intThe ordering of the expense entry columns.
custom_labelstringThe label of the custom entry table.
custom_column_nameslist of stringThe names of the custom entry columns (project, 3 codes, comment).
custom_column_prioritylist of intThe ordering of the custom entry columns.
allow_blank_commentsbooleanIf true, blank comments are allowed; if false, they must not be blank.
time_gridstring
time_view_futureboolean
time_view_pastboolean
expense_view_futureboolean
expense_view_pastboolean
custom_view_futureboolean
custom_view_pastboolean

ExpenseCodeRecord

An item in the "expense code" column (or its renamed equivalent) of expense records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.

ExpenseCurrencyRecord

An item in the "currency" column (or its renamed equivalent) of expense records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.

ExpenseGUI

Objects of this type may be members of groups. The following related methods are available:

Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 12.5.

  • code_expense_4_priority
  • code_expense_4_default
  • code_expense_5_priority
  • code_expense_5_default
  • code_expense_6_priority
  • code_expense_6_default
  • code_expense_7_priority
  • code_expense_7_default
  • text2_priority
  • text2_default
  • text3_priority
  • text3_default
  • text2_max_chars
  • text3_max_chars
FieldTypeDescription
id_expense_guistring
pnamestring
project_priorityint
project_defaultstring
expense_priorityint
expense_defaultstring
comment_priorityint
comment_defaultstring
currency_priorityint
currency_defaultstring
source_priorityint
source_defaultstring
id_domainstring
auto_addint
reserved1string
arrowsint
totalsstring
projecttreestring
backwardsint
blankrowsstring
javascriptint
projectdescint
diary_notesstring
future2string
future3string
future4string
future5string
future6string
future7string
future8string
pre_htmlstring
post_htmlstring
max_attachmentsint
attachment_ruleint
use_deps_for_hiddenint
comment_max_charsint
use_suggestionsint
code_expense_4_priorityint
code_expense_4_defaultstring
code_expense_5_priorityint
code_expense_5_defaultstring
code_expense_6_priorityint
code_expense_6_defaultstring
code_expense_7_priorityint
code_expense_7_defaultstring
text2_priorityint
text2_defaultstring
text3_priorityint
text3_defaultstring
text2_max_charsint
text3_max_charsint

ExpenseMileageConversion

A mileage-to-expense conversion rate definition.

FieldTypeDescription
id_mileage_conversionstringThe ID of this record.
start_datestringThe starting date for this rate to be used.
stop_datestringThe stop date for this rate to be used.
id_domainstringThe domain this rate is in, if any.
id_code_expensestringThe expense code for the conversion.
ratestringThe rate of conversion from miles (or other travel units) to expenses.
id_currencystringThe conversion currency.

ExpenseRecord

An entry in the expense record table. Note that there may be more than one record for a single project/code/date combo which will be combined when shown in the web UI, and that amounts may be negative to represent corrections.

The following basic CRUD methods are available for this type:

Automatic name to ID conversion is available for this type, for the following fields:

user, project, expense_code, currency, source, expense4, expense5, expense6, expense7. Name conversion is performed by the following variant methods:

Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 10.0.

  • id_assignment
Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 11.2.

  • id_suggestion
Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 12.5.

  • id_code_expense_4
  • id_code_expense_5
  • id_code_expense_6
  • id_code_expense_7
  • text2
  • text3
FieldTypeDescription
idstringThe record ID.
userstringThe record's user ID (not login).
datestringThe date of the record, in YYYYMMDD format.
projectstringThe record's project ID.
expense_codestringThe record's expense code (or renamed equivalent) ID.
amountdoubleThe amount of expense units represented by the record.
commentstringThe comment for this record.
committedbooleanReserved; cannot be modified through the jxAPI.
currencystringThe record's currency (or renamed equivalent) ID.
sourcestringThe record's expense source (or renamed equivalent) ID.
domainstringThe domain ID for this record, if any.
rocommentstringRead only comment.
flagsstringDeprecated; do not use.
picturestringDeprecated; do not use.
extra1stringReserved; do not use.
extra2stringReserved; do not use.
created_bystringThe ID of the user that created this record.
create_timedoubleCreation timestamp, in seconds since epoch.
modified_bystringThe ID of the user that last modified this record.
modify_timedoubleModification timestamp, in seconds since epoch.
mileagedoubleTravel distance for automatic conversion.
id_assignmentstringID of assignment associated with this record.
id_suggestionintID of suggestion associated with this record.
id_code_expense_4stringOptional Expense Entry Field 4
id_code_expense_5stringOptional Expense Entry Field 5
id_code_expense_6stringOptional Expense Entry Field 6
id_code_expense_7stringOptional Expense Entry Field 7
text2stringOptional Expense Entry Text 2
text3stringOptional Expense Entry Text 3

ExpenseSourceRecord

An item in the "expense source" column (or its renamed equivalent) of expense records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.

GroupRecord

A group.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

FieldTypeDescription
idstringThe group id.
descriptionstringThe group description.
namestringThe group name.
parentstringThe ID of the group's parent group, if any.
domainstringThe ID of the group's domain, if any.
typeintThe group type. 1 for regular groups, other numbers for PS, ProjectLink, PX, etc.

ImportResults

Results of running an import on the server.

FieldTypeDescription
messageslist of stringA list of informational messages from the import module, if any.
warningslist of stringA list of warning messages from the import module, if any.
errorslist of stringA list of error messages from the import module, if any.

Item

FieldTypeDescription
keystring
valueany

MemorizedEntries

A list of memorized entries that apply to a specific entry type and user or group.

FieldTypeDescription
idstringThe ID of the user or group.
typestringThe entry type.
entrieslist of MemorizedEntryThe list of memorized entries.

MemorizedEntry

A saved entry row that is added to new sheets in the web UI for user convenience.

FieldTypeDescription
idstringThe ID of this memorized entry.
groupstringThe ID of this memorized entry's group.
projectstringThe ID of the memorized project.
code1stringThe ID of the first memorized code column.
code2stringThe ID of the second memorized code column.
code3stringThe ID of the third memorized code column.
commentstringThe memorized comment.

MileageGUI

Objects of this type may be members of groups. The following related methods are available:

Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 12.5.

  • code_custom_4_priority
  • code_custom_4_default
  • code_custom_5_priority
  • code_custom_5_default
  • code_custom_6_priority
  • code_custom_6_default
  • code_custom_7_priority
  • code_custom_7_default
  • text2_priority
  • text2_default
  • text3_priority
  • text3_default
  • text2_max_chars
  • text3_max_chars
FieldTypeDescription
id_travel_entry_guistring
pnamestring
project_priorityint
project_defaultstring
reason_priorityint
reason_defaultstring
comment_priorityint
comment_defaultstring
measurement_priorityint
measurement_defaultstring
vehicle_priorityint
vehicle_defaultstring
id_domainstring
auto_adddouble
reserved1string
arrowsint
totalsstring
projecttreestring
backwardsint
blankrowsstring
javascriptint
projectdescint
diary_notesstring
future2string
future3string
future4string
future5string
future6string
future7string
future8string
pre_htmlstring
post_htmlstring
max_attachmentsint
attachment_ruleint
use_deps_for_hiddenint
comment_max_charsint
use_suggestionsint
code_custom_4_priorityint
code_custom_4_defaultstring
code_custom_5_priorityint
code_custom_5_defaultstring
code_custom_6_priorityint
code_custom_6_defaultstring
code_custom_7_priorityint
code_custom_7_defaultstring
text2_priorityint
text2_defaultstring
text3_priorityint
text3_defaultstring
text2_max_charsint
text3_max_charsint

MileageMeasurementRecord

An item in the "measurement" column (or its renamed equivalent) of travel/custom records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.

MileageReasonRecord

An item in the "reason" column (or its renamed equivalent) of travel/custom records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.

MileageRecord

An entry in the custom record table. Note that there may be more than one record for a single project/code/date combo which will be combined when shown in the web UI, and that amounts may be negative to represent corrections.

The following basic CRUD methods are available for this type:

Automatic name to ID conversion is available for this type, for the following fields:

user, project, reason, vehicle, measurement, custom4, custom5, custom6, custom7. Name conversion is performed by the following variant methods:

Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 10.0.

  • id_assignment
Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 11.2.

  • id_suggestion
Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 12.5.

  • id_code_custom_4
  • id_code_custom_5
  • id_code_custom_6
  • id_code_custom_7
  • text2
  • text3
FieldTypeDescription
idstringThe record ID.
userstringThe record's user ID (not login).
datestringThe date of the record, in YYYYMMDD format.
projectstringThe record's project ID.
reasonstringThe record's reason (or renamed equivalent) ID.
distancedoubleThe amount of custom units represented by the record.
commentstringThe comment for this record.
committedbooleanReserved; cannot be modified through the jxAPI.
measurementstringThe record's measurement (or renamed equivalent) ID.
vehiclestringThe record's vehicle (or renamed equivalent) ID.
domainstringThe domain ID for this record, if any.
extrastringReserved; do not use.
flagsstringDeprecated; do not use.
created_bystringThe ID of the user that created this record.
create_timedoubleCreation timestamp, in seconds since epoch.
modified_bystringThe ID of the user that last modified this record.
modify_timedoubleModification timestamp, in seconds since epoch.
id_assignmentstringID of assignment associated with this record.
id_suggestionintID of suggestion associated with this record.
id_code_custom_4stringOptional Custom Entry Field 4
id_code_custom_5stringOptional Custom Entry Field 5
id_code_custom_6stringOptional Custom Entry Field 6
id_code_custom_7stringOptional Custom Entry Field 7
text2stringOptional Custom Entry Text 2
text3stringOptional Custom Entry Text 3

MileageVehicleRecord

An item in the "vehicle" column (or its renamed equivalent) of travel/custom records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.

MobileAppSettings

Extra server-configurable settings related to the Journyx mobile app.

FieldTypeDescription
time_submit_enabledbooleanTrue if mobile time submission is allowed.

NoteRecord

A note record.

Automatic name to ID conversion is available for this type, for the following fields:

user, project. Name conversion is performed by the following variant methods:

warning

Missing links here.

FieldTypeDescription
idstringThe ID of this record.
note_rec_startstringDeprecated; now always the same as 'id'.
userstringThe ID of the user that this note is associated with.
projectstringThe ID of the project that this note is associated with.
update_timestampdoubleTime when the note was updated, in seconds since epoch.
the_textstringThe note text.
chunkstringDeprecated; do not use.
domainstringThe ID of the domain this note is in, if any.
time_recstringThe ID of the time record this note is associated with, if any.
expense_recstringThe ID of the expense record this note is associated with, if any.
travel_recstringThe ID of the travel/custom rec this note is associated with, if any.
vid_objectstring
table_namestring
correctionint
lockedint

Period

This type encapsulates all information about a period for a specific user, specifically all three sheets (time, expense, and custom) that cover a specific requested date. Note that the sheets may not actually contain all row data, if only the header information was requested.

FieldTypeDescription
time_sheetSheetThe user's time sheet.
expense_sheetSheetThe user's expense sheet.
custom_sheetSheetThe user's custom sheet.

Prediction

FieldTypeDescription
id_itemstring
relevancedouble

ProjectApproval

A project approval entry.

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_projectapprovalstringThe ID of the project approval entry.
id_projectstringThe ID of the project.
id_domainstringThe domain ID, if any.

ProjectApprovalInfo

An entry in the project approval queue.

FieldTypeDescription
idstringThe ID of the approval queue entry.
project_idstringThe ID of the project to approve.
project_namestringThe printable name of the project to approve.
sheet_idstringThe ID of the sheet to approve the project on.
user_loginstringThe login ID of the user whose sheet it is.
user_namestringThe name of the user whose sheet it is.
typestringOne of 'time', 'expense', or 'mileage'.
periodstringThe name of the period the sheet is based on.
levelstringThe level at which the sheet is to be approved.
amountdoubleThe amount of hours, expense units, or custom units reported.
approver_loginstringThe login ID of the current approver.
approver_namestringThe full name of the current approver.
statestringThe current state: 'APPROVED', 'NOT APPROVED', or 'REJECTED'.
user_idstringThe ID of the user whose sheet it is.
approver_idstringThe ID of the current approver.

ProjectApprovalSetting

A project approval setting.

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_projectapprovalsettingsstringThe ID of this setting.
id_projectapprovalstringThe ID of the project approval entry this setting applies to.
setting_typestringThe setting type.
small_stringstringThe value of the setting, if it is a small string.
mid_stringstringThe value of the setting, if it is a medium sized string.
big_stringstringThe value of the setting, if it is a big string.
integerintThe value of the setting, if it is an integer.
id_domainstringThe domain ID, if any.

ProjectApprover

An approver for projects.

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_projectapproverstringThe ID for this record.
id_projectapprovalstringThe ID of the project approval entry this approver is associated with.
id_userstringThe ID of the approver's user record.
levelintWhat level of approval this user is responsible for.
id_domainstringThe domain ID, if any.

ProjectCodeRate

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_ratestring
id_projectstring
id_codestring
start_datestring
stop_datestring
pay_ratedouble
bill_ratedouble
descriptionstring
id_domainstring

ProjectDependencies

Code column dependencies (IDs only) for a single project.

  • This type is not available in the following endpoints: zsi
FieldTypeDescription
project_idstringThe project ID.
project_namestringThe project's displayed name.
project_descriptionstringThe project's description.
mileage_vehicleslist of string
codes_bill_typeslist of string
codes_expenseslist of string
codes_pay_typeslist of string
mileage_reasonslist of string
mileage_measurementslist of string
codes_taskslist of string
codes_currencieslist of string
codes_expense_sourceslist of string
codes_time_4list of string
codes_time_5list of string
codes_time_6list of string
codes_time_7list of string
codes_expense_4list of string
codes_expense_5list of string
codes_expense_6list of string
codes_expense_7list of string
codes_custom_4list of string
codes_custom_5list of string
codes_custom_6list of string
codes_custom_7list of string

ProjectExtra

Extra information about a project, containing fields that are not accessible from the jxAPI prior to 10.0.

  • This type is not available in the following endpoints: zsi
FieldTypeDescription
project_idstringThe project ID.
allow_timeint1 if the project is allowed to be used in time entry.
allow_expenseint1 if the project is allowed to be used in expense entry.
allow_customint1 if the project is allowed to be used in custom/travel entry.
allow_leaveint1 if the project can be used to book leave requests.
allow_holidayint1 if the project can be used to book holiday time off.

ProjectPickerItem

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_project_pickerstring
id_projectstring
acl_typedouble
id_userstring
id_domainstring
reserved1string
reserved2string
reserved3string
reserved4string

ProjectRecord

A project. Note that some fields refer to features that may not be available in your version of Journyx.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

Automatic name to ID conversion is available for this type, for the following fields:

parent, creator. Name conversion is performed by the following variant methods:

Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 10.0.

  • allow_time
  • allow_expense
  • allow_custom
  • allow_leave
  • allow_holiday
Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 12.1.

  • multiple_assns
Data types and versions

Note that the data types of certain fields like estimate and percent_done were int types in versions prior to 10.0, but are now double types.

FieldTypeDescription
idstringThe project ID.
descriptionstringThe project description.
parentstringThe ID of the project's parent project.
estimatedoubleEstimated hours to complete the project.
percent_donedoubleThe percent of the project that is completed.
creatorstringThe ID of the user that created the project.
loggablestringIs the project loggable?
namestringThe project name.
domainstringThe ID of the domain this project is in, if any.
typedoubleProject record type; generally always 1.
ownerstringThe ID of the user that owns this project.
backup_ownerstringThe ID of the backup owner of this project.
scheduled_workdoublePX scheduled work
scheduled_startdoublePX scheduled start
scheduled_enddoublePX scheduled end
scheduled_durationdoublePX scheduled duration
projected_costdoubleBudget projected cost
projected_returndoubleBudget projected return
projected_profitdoubleBudget projected profit
projected_roidoubleBudget projected ROI
awaiting_exportintIs this project awaiting export with ProjectLink?
is_hiddenintIs the project hidden?
allow_timeintCan time be booked against the project?
allow_expenseintCan expenses be booked against the project?
allow_customintCan travel/custom be booked against the project?
allow_leaveintCan leave requests be booked against the project?
allow_holidayintCan holidays be booked against the project?
propagate_pa_ratesint
multiple_assnsint
agile_team_assnsint

PS_DV_Assignments

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_custom_field_recstring
create_timestampdouble
creatorstring
start_datestring
id_domainstring
id_rulestring
id_groupstring
pay_groupstring
apply_to_allint

PS_DV_Rules

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_custom_field_recstring
create_timestampdouble
creatorstring
start_datestring
id_domainstring
rule_categorystring
selection_valuesstring
selection_tablestring
selection_and_orint
actionstring
action_detailstring
scopestring
comparisonstring
emptyint
target_valuesstring
target_tablestring
target_and_orint
amountint
messagestring

PSAccrualOverride

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_custom_field_recstring
create_timestampdouble
creatorstring
start_datestring
userstring
paytypestring
bonusmonthsdouble
carryoverlimitoverridedouble
accrualssuspendedstring
applycarryoverstring

PSAccrualTierManager

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_custom_field_recstring
create_timestampdouble
creatorstring
start_datestring
empaccrualtypestring
floordouble
paytypestring
hoursgranteddouble
accrualtypestring
defaultcarryoverlimitdouble
applycalculationstring
applycarryoverstring
carryoverprioritystring
proratestring

PSCompensationTierManager

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_custom_field_recstring
create_timestampdouble
creatorstring
start_datestring
empaccrualtypestring
floordouble
loggedpaytypestring
earnedpaytypestring
multiplierdouble
expirationwindowint
accrualtypestring
defaultcarryoverlimitdouble
applycalculationstring
applycarryoverstring
carryoverprioritystring

PSMileageConversionResult

FieldTypeDescription
convertedboolean
expense_recExpenseRecord
mileage_recMileageRecord

PunchGUI

Objects of this type may be members of groups. The following related methods are available:

FieldTypeDescription
id_punch_guistring
descriptionstring
logout_afterdouble
display_memorizeddouble
display_recent_punchesdouble
how_many_daysdouble
show_totalsdouble
button_recentdouble
button_currentdouble
button_accrualsdouble
show_project_hierdouble
reserved1double
group_prioritydouble
group_defaultstring
project_prioritydouble
project_defaultstring
task_prioritydouble
task_defaultstring
pay_type_prioritydouble
pay_type_defaultstring
bill_type_prioritydouble
bill_type_defaultstring
comment_prioritydouble
comment_defaultstring
id_domainstring
pre_htmlstring
post_htmlstring
code_time_4_priorityint
code_time_4_defaultstring
code_time_5_priorityint
code_time_5_defaultstring
code_time_6_priorityint
code_time_6_defaultstring
code_time_7_priorityint
code_time_7_defaultstring
text2_priorityint
text2_defaultstring
text3_priorityint
text3_defaultstring

PunchRecord

A punch entry.

The following basic CRUD methods are available for this type:

Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 12.5.

  • id_code_time_4
  • id_code_time_5
  • id_code_time_6
  • id_code_time_7
  • text2
  • text3
FieldTypeDescription
id_punchstringThe ID of this record.
id_userstringThe ID of the user who punched in or out.
record_datestringThe date (YYYYMMDD) of this record.
id_code_taskstringThe ID of the task (or renamed equivalent column) punched into/out of.
id_code_pay_typestringThe ID of the pay type (or renamed equivalent column) punched into/out of.
id_projectstringThe ID of the project punched into/out of.
punch_datetimestringThe date and time of the punch, in ISO8601 format.
commentstringThe comment for this punch.
id_time_recstringThe time record associated with this punch, if it has been converted to one.
when_exportedstringWhen the punch was exported, in ISO8601 format.
id_code_bill_typestringThe ID of the bill type (or renamed equivalent column) punched into/out of.
pre_or_postdoubleIf 0, the in punch determines time record fields; if 1, the out punch does.
id_groupstringThe ID of the group this punch is in.
id_code_time_4string
id_code_time_5string
id_code_time_6string
id_code_time_7string
text2string
text3string

PXTeamRecord

A Team for PX Resources and assignment planning.

Team visibility (for management purposes) and team membership are both stored in the access_control_lists table. Use ACL Type 50 to determine the special membership group ID for a team. Use ACL Type 1 to determine what users belongs to that membership group ID. Use ACL Type 51 to determine viewability of Teams for management purposes.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe team id.
namestringThe team name.
descriptionstringThe team description.
team_typeintThe type of team - usually 1.
creatorstringThe user ID who created the team.
create_timestampdoubleThe epoch datetime when the team was created.
modifierstringThe user ID who last modified the team.
modify_timestampdoubleThe epoch datetime when the team was last modified.
domainstringThe ID of the group's domain, if any.
auto_adddouble1 means automatically add to newly created groups. 0 to turn off.

RateCodeRecord

Rate Codes for rules and policies. Used to apply a code to a rate instead of a numeric value.

Warning: not available in all endpoints

Please note that the availability of this record type or certain fields in it may vary depending on if you access a versioned or unversioned endpoint. The unversioned endpoint typically corresponds to the oldest available versioned endpoint.

This field became available in the 10.0 endpoint.

The following basic CRUD methods are available for this type:

This type is searchable. The following related methods are available:

FieldTypeDescription
idstringThe rate code id.
namestringThe rate code name.
descriptionstringThe rate code description.
domainstringThe ID of the rate code's domain, if any.
activeint1 if active.

RateRule

A business rule.

FieldTypeDescription
idstring
namestring
descriptionstring
projectlist of string
codelist of string
subcodelist of string
othercodelist of string
hoursdouble
timeframestring
actionTypestring
autorejectboolean
reasonstring
conditionstring
dayslist of string
autoaccrualboolean
accrueitemstring
descendantsboolean

RawSuggestion

FieldTypeDescription
json_datastring
source_datalist of Item
extra_propertieslist of Item

RecordStructureElement

FieldTypeDescription
namestring
typestring

RequestRecord

The following basic CRUD methods are available for this type:

Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 12.5.

  • id_code_time_4
  • id_code_time_5
  • id_code_time_6
  • id_code_time_7
  • text2
  • text3
FieldTypeDescription
id_request_recstring
id_userstring
record_datestring
id_code_taskstring
id_code_pay_typestring
id_projectstring
time_amountdouble
commentstring
commit_stateint
id_domainstring
id_code_bill_typestring
id_groupstring
reject_flagint
id_rejectorstring
extramidstring
extrabigstring
extraintint
extrasmsstring
submit_datestring
decline_datestring
decline_reasonstring
id_holiday_typestring
notestring
id_code_time_4string
id_code_time_5string
id_code_time_6string
id_code_time_7string
text2string
text3string

RoleRecord

Objects of this type may be members of groups. The following related methods are available:

FieldTypeDescription
id_rolestring
descriptionstring
abilitiesstring
id_domainstring
pnamestring
auto_adddouble
role_typestring
is_hiddendouble

RowPunch

This type holds a single pair of in/out punch times and the time_rec id, if any, connected to the punches.

FieldTypeDescription
time_instringThe in time, in HHMMSS format.
time_outstringThe out time, in HHMMSS format.
mod_idstringThe time rec id or an empty string.

RowPunchList

This type holds in/out times for a single date in a row.

FieldTypeDescription
puncheslist of RowPunchZero or more RowPunch objects each representing an in/out time pair.

RuleSet

A set of business rules.

FieldTypeDescription
namestring
descriptionstring
ruleslist of RuleSetRow
payRateOriginstring
billRateOriginstring

RuleSetRow

One row in a business rule set.

FieldTypeDescription
rulestring
paytypestring
payamountdouble
billtypeAstring
billamountAdouble
billtypeBstring
billamountBdouble
billtypeCstring
billamountCdouble

Sheet

This type encapsulates an entire time/expense/custom sheet, including essentially all of the information shown in the web UI for that sheet.

FieldTypeDescription
idstringThe sheet ID.
userstringThe ID of the user this sheet belongs to.
user_loginstringThe login of the user this sheet belongs to.
user_namestringThe full name of the user this sheet belongs to.
typestringThe sheet type (eg. 'time', 'expense', or 'mileage').
dateslist of stringA list of dates (YYYYMMDD format) in the sheet. For each entry in this list, there will be one column in each row of the sheet.
statestringThe sheet's state.
statusstringA message describing the sheet's status.
approverstringThe ID of the next user that must approve the sheet.
levelintThe next approval level of the sheet.
reasonstringThe reason this sheet was rejected, if any.
totaldoubleThe total (hours, or expense/custom units) for the sheet.
modified_atstringThe date/time the sheet was last modified.
audit_settingsSheetAuditSettingsThe sheet's audit settings.
rowslist of SheetRowOne SheetRow structure per project/code combo in the sheet.
punchlistslist of SheetPunchListOne SheetPunchList containing in/out times per date in the sheet.
column_datastring
can_be_submittedbooleanNew in v10 endpoint

SheetAuditSettings

Extra audit-related, server-configurable settings for a user sheet.

FieldTypeDescription
requires_new_entriesbooleanTrue if sheets require new entries to be resubmitted.
has_ever_been_submittedbooleanTrue if the sheet has ever been submitted.
requires_correction_recsbooleanTrue if the sheet requires correction records instead of modifying existing ones.
audit_level_settingstringThe audit level setting of the sheet.

SheetCell

This type represents a single cell in a sheet, equivalent to one entry cell in the web UI.

FieldTypeDescription
amountdoubleThe total amount (hours, or expense/custom units) in this cell.
reasonstring
errorboolean
noteslist of CellNoteNotes for this cell, if any.
attachmentslist of stringThe encoded IDs of this cell's attachments, if any.

SheetInfo

Metadata for a sheet. Similar to the Sheet type, but doesn't include the sheet rows, attachments, notes, etc.

FieldTypeDescription
idstringThe sheet ID.
userstringThe ID of the user this sheet belongs to.
user_loginstringThe login of the user this sheet belongs to.
user_namestringThe full name of the user this sheet belongs to.
typestringThe sheet type (eg. 'time', 'expense', or 'mileage').
start_datestringThe start date of the sheet (YYYYMMDD).
end_datestringThe end date of the sheet (YYYYMMDD).
statestringThe sheet's state.
approverstringThe ID of the next user that must approve the sheet.
levelintThe next approval level of the sheet.
reasonstringThe reason this sheet was rejected, if any.
totaldoubleThe total (hours, or expense/custom units) for the sheet.

SheetObject

Metadata describing a sheet, in the old format used by certain pre-9.5 methods.

FieldTypeDescription
typestringOne of 'time', 'expense', or 'mileage'.
idstringThe SheetObject ID.
userstringThe ID of the sheet's user.
timesheetstringThe ID of the underlying sheet object.
pnamestringThe name of the sheet.
stateint0=open, 1=submitted, 2=approved, 3=rejected
startstringStarting date of the sheet.
endstringEnd date of the sheet.
approverstringNext approver for the sheet.
levelintApproval level of the sheet.
domainstringDomain ID of the sheet, if any.
reasonstringReason the sheet was rejected, if any.

SheetPunch

This type holds a single pair of in/out punch times.

FieldTypeDescription
time_instringThe in time, in HHMMSS format.
time_outstringThe out time, in HHMMSS format.

SheetPunchList

This type holds in/out times for a single date in a sheet.

FieldTypeDescription
puncheslist of SheetPunchZero or more SheetPunch objects each representing an in/out time pair.

SheetRow

This type represents one row of a sheet. Similar to its appearance in the web UI, a row has a single set of project and code column values, comment, and a cell for each date in the sheet. If the sheet supports in/out times, it will also have a punchlists field containing in/out time lists for each date in the sheet.

FieldTypeDescription
projectstringThe ID of this row's project.
project_namestringThe displayed name of this row's project.
code0stringThe ID of this row's first code (task, expense code, or reason).
code0_namestringThe displayed name of this row's first code.
code1stringThe ID of this row's second code (pay type, currency, or measurement).
code1_namestringThe displayed name of this row's second code.
code2stringThe ID of this row's third code (bill type, source, or vehicle).
code2_namestringThe displayed name of this row's second code.
commentstringThis row's comment.
cellslist of SheetCellOne SheetCell per date in ths sheet.
punchlistslist of RowPunchListOne RowPunchList per date in the sheet, if the sheet supports in/out times.

SheetSaveResult

FieldTypeDescription
sheetSheet
successboolean
statuslist of string
errorslist of string
extra_datalist of Item

SheetStatusRecord

Description of a change that has been or is to be made to a sheet's status.

FieldTypeDescription
idstringThe ID of the sheet.
changestringEither 'approve' or 'reject'.
reasonstringThe reason for rejecting a sheet, if any.
statusstringA message describing the result of the change request.

SingleSignOnStatus

Describe whether Single Sign On (SSO) is enabled.

Warning: not available in all endpoints

Please note that the availability of this record type or certain fields in it may vary depending on if you access a versioned or unversioned endpoint. The unversioned endpoint typically corresponds to the oldest available versioned endpoint.

This field became available in the 10.0 endpoint.

FieldTypeDescription
ssoEnabledbooleanTrue if single sign on is enabled and active.
loginURLstringURL to initiate the sign in process.
ssoTypestringA string describing the type of Single Sign On enabled, if any.

SubcodeRecord

An item in the "pay types" column (or its renamed equivalent) of time records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.
require_accrualintDoes this item require an associated Accrual to be used?

SubsubcodeRecord

An item in the "bill types" column (or its renamed equivalent) of time records.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be loggable or non-loggable. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

FieldTypeDescription
idstringThe item ID.
descriptionstringThe item description.
reserved0doubleReserved field; do not use.
autoadddoubleIf 1, automatically add this item to all new groups.
reserved1stringReserved field; do not use.
loggablestringIf not "0", 0, or null, this item is loggable.
domainstringThe item's domain ID, if any.
pretty_namestringThe item's displayed name.

SuggestionRecord

A suggested time, expense, or custom entry, with associated Suggestion Engine data.

Because a suggestion can have many and varying properties, this object has only a single field, "properties", which contains a list of key/value pairs. In typed endpoints this is a list of "Item" objects (each of which has a "key" and "value" field), while in untyped endpoints it will use the endpoint's dictionary or mapping type.

Some of the properties of interest include:

  • id_suggestion: (int) the suggestion ID
  • id_user: the ID of the user the suggestion belongs to
  • source_category: the source of the suggestion, eg. "generic" or "exchange_rest" Limit of 252 chars. These are either built-in identifiers as above or identifiers produced through custom PS sources.
  • source_id: an ID supplied by the source that can be used to find this suggestion later
  • record_date/record_date_end: YYYYMMDD date range of the suggestion
  • start_timestamp/end_timestamp: Unix seconds-since-epoch date range of the suggestion
  • series_id - (int) ID of the series the suggestion is part of, if any
  • id_project, id_group, comment: column data
  • id_code_task, id_code_pay_type, id_code_bill_type: column data for time records
  • id_code_expense, id_code_currency, id_code_expense_source: column data for expense records
  • id_travel_reason, id_travel_measurement, id_travel_vehicle: column data for custom records
  • time_amount, expense_amount, custom_amount: amount for t/e/c records
  • mileage: for expense records
  • is_all_day: is it an all day event?
  • subtype: subtype within a source, eg. "Event" or "Task"

There are many more potential properties, but these are the ones most likely to be used when using suggestions from the jxAPI.

FieldTypeDescription
propertieslist of ItemA list of suggestion properties.

SuggestionRefreshResult

FieldTypeDescription
num_new_eventsint
num_updated_eventsint
num_unchanged_eventsint
num_actualized_eventsint
bad_auth_sourceslist of string
num_suggestionsint
num_hidden_eventsint
actualized_eventslist of SuggestionRecord
suggestions_listlist of SuggestionRecord
hidden_eventslist of SuggestionRecord

TimeGUI

Objects of this type may be members of groups. The following related methods are available:

Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 12.5.

  • allocated_must_match_punches
  • code_time_4_priority
  • code_time_4_default
  • code_time_5_priority
  • code_time_5_default
  • code_time_6_priority
  • code_time_6_default
  • code_time_7_priority
  • code_time_7_default
  • text2_priority
  • text2_default
  • text3_priority
  • text3_default
  • text2_max_chars
  • text3_max_chars
FieldTypeDescription
id_guistring
griddouble
sidewaysdouble
arrowsdouble
totalsstring
startstopdouble
time_formatdouble
anchorstring
days_backstring
backwardsdouble
blankrowsstring
show_mileage_entrydouble
row_orderdouble
group_priorityint
group_defaultstring
project_priorityint
project_defaultstring
task_priorityint
task_defaultstring
pay_type_priorityint
pay_type_defaultstring
bill_type_priorityint
bill_type_defaultstring
comment_priorityint
comment_defaultstring
comment_max_charsint
pre_htmlstring
post_htmlstring
last_modifiedstring
auto_adddouble
pnamestring
id_domainstring
javascriptint
show_project_descint
id_timesheetstring
diary_notesdouble
entry_input_typedouble
minute_incrementdouble
max_attachmentsint
attachment_ruleint
use_deps_for_hiddenint
use_suggestionsint
use_24_hourint
show_interim_submitint
default_vue_screenstring
allocated_must_match_punchesint
code_time_4_priorityint
code_time_4_defaultstring
code_time_5_priorityint
code_time_5_defaultstring
code_time_6_priorityint
code_time_6_defaultstring
code_time_7_priorityint
code_time_7_defaultstring
text2_priorityint
text2_defaultstring
text3_priorityint
text3_defaultstring
text2_max_charsint
text3_max_charsint

TimeRecord

An entry in the time record table. Note that there may be more than one record for a single project/code/date combo which will be combined when shown in the web UI, and that amounts may be negative to represent corrections.

The following basic CRUD methods are available for this type:

Automatic name to ID conversion is available for this type, for the following fields:

user, project, code, subcode, subsubcode, time4, time5, time6, time7. Name conversion is performed by the following variant methods:

Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 10.0.

  • id_assignment
Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 11.2.

  • id_suggestion
Warning: availability of fields

The following fields are not available in the unversioned endpoint, or in versioned endpoints prior to 12.5.

  • id_code_time_4
  • id_code_time_5
  • id_code_time_6
  • id_code_time_7
  • text2
  • text3
FieldTypeDescription
idstringThe record ID.
userstringThe record's user ID (not login).
datestringThe date of the record, in YYYYMMDD format.
codestringThe record's task (or renamed equivalent) ID.
subcodestringThe record's pay type (or renamed equivalent) ID.
projectstringThe record's project ID.
hoursdoubleThe amount of hours represented by the record.
commentstringThe comment for this record.
committedbooleanReserved; cannot be modified through the jxAPI.
domainstringThe domain ID for this record, if any.
subsubcodestringThe record's bill type (or renamed equivalent) ID.
groupstringThe record's group ID.
created_bystringThe ID of the user that created this record.
create_timedoubleCreation timestamp, in seconds since epoch.
modified_bystringThe ID of the user that last modified this record.
modify_timedoubleModification timestamp, in seconds since epoch.
id_assignmentstringID of assignment associated with this record.
id_suggestionintID of suggestion associated with this record.
id_code_time_4stringOptional Time Entry Field 4
id_code_time_5stringOptional Time Entry Field 5
id_code_time_6stringOptional Time Entry Field 6
id_code_time_7stringOptional Time Entry Field 7
text2stringOptional Time Entry Text 2
text3stringOptional Time Entry Text 3

UserDetails

Contains several bits of useful information about a user including full name, login, email, role IDs, ability IDs, custom fields, and full user rec.

FieldTypeDescription
userIdstringThe user database ID.
userRecordUserRecordThe full UserRecord (database record) for this user.
fullNamestringThe users full (complete) name in the system.
firstNamestringThe users first name (only) in the system.
lastNamestringThe users last name (only) in the system.
loginstringThe users login (aka username).
emailstringThe users email address as recorded in the system.
abilitieslist of stringThe list of ability IDs that this users possesses.
roleIdslist of stringThe list of role IDs that this users possesses. (Roles contain abilities.)
attributesAttributeQueryResultThe custom field values (attributes) for this user.

UserExpenseSheet

Metadata about an expense sheet.

FieldTypeDescription
id_sheetstring
id_timesheetstring
id_userstring
pnamestring
statedouble
start_datestring
end_datestring
id_domainstring
levelint

UserMileageSheet

Metadata about a travel/custom sheet.

FieldTypeDescription
id_sheetstring
id_timesheetstring
id_userstring
pnamestring
statedouble
start_datestring
end_datestring
id_domainstring
levelint

UserRecord

Record representing a Journyx user.

Note that some users may have an ID that is the same as their login name; do not depend on this.

The following basic CRUD methods are available for this type:

This type may have custom fields. In addition to the core attribute methods, the following type specific methods are available:

Objects of this type may be members of groups. The following related methods are available:

Objects of this type may be hidden. The following related methods are available:

Automatic name to ID conversion is available for this type, for the following fields:

time_gui, expense_gui, mileage_gui. Name conversion is performed by the following variant methods:

FieldTypeDescription
idstringThe ID of the user (not login name!).
num_inputintNumber of input records.
num_datesintNumber of dates.
full_namestringThe user's full name.
default_commentstringThe default comment for this user.
expense_guistringThe ID of this user's expense screen definition.
time_guistringThe ID of this user's time screen definition.
domainstringThe user's domain ID, if any.
mileage_guistringThe ID of this user's travel/custom screen definition.
user_loginstringThe user's login name.
is_hiddenintIs the user hidden?

UserRole

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_user_rolestring
id_userstring
id_rolestring
modifierstring
modify_timestampdouble

UserSheetNote

Sheet History records about an entry / time sheet.

"extra_string_2" is actually the relevant user ID, such as who is approving. The note_creator will be System for approval events, or the original user for ordinary sheet notes.

The following basic CRUD methods are available for this type:

This type is searchable. The following related methods are available:

FieldTypeDescription
id_usersheetnotestring
id_usersheetstring
note_textstring
note_creatorstring
create_timestampdouble
extra_string_1string
extra_string_2string
extra_string_3string
id_domainstring

UserTimeSheet

Metadata about a time sheet.

FieldTypeDescription
id_sheetstring
id_timesheetstring
id_userstring
pnamestring
statedouble
start_datestring
end_datestring
id_domainstring
levelint

VirtualSheetRecord

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_virtual_sheet_recordstring
id_virtual_sheetstring
id_recordstring
record_typestring

VirtualTimeSheet

The following basic CRUD methods are available for this type:

FieldTypeDescription
id_sheetstring
id_timesheetstring
id_userstring
pnamestring
statedouble
start_datestring
end_datestring
id_domainstring
id_approverstring
levelint
reserved1string
id_parent_sheetstring
creatorstring
create_timestampdouble