Skip to content

Rippling: Retrieve a specific worker — response body — level

Retrieve a specific worker: response body, field level. Complete fields and constraints for contract 2026-10-28.

API reference · Contract 2026-10-28

SDK schema: Retrieve a specific worker — response body — level

FieldTypePresenceDescription and constraints
$objectRootThe level of the worker.

Expandable field
created_atstringRequired within parentRecord creation date
descriptionstringOptionalThe description of the level.
experience_requirementsstringOptionalThe experience requirements for the level.
global_levelJSONOptional
global_level (anyOf 1)integerAlternativeGlobal level is used to track the seniority of levels. The higher up a level is placed on the page, the more senior and higher-ranked the level. Global level is used in workflows, policies, and reports that use the level attribute (e.g., you can use Level Lookup to set up a workflow that notifies the nearest person in an worker’s management chain at or above the specified level).
global_level (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
idstringRequired within parentIdentifier field
namestringRequired within parentThe name of the level. Must be unique within the company or organization.
parentModelOptionalExpand Update a level — response body — parent
The parent level.

Expandable field
parent_idstringOptionalThe parent level.
rankJSONOptional
rank (anyOf 1)integerAlternativeThe rank of the level within its track.
rank (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
scope_of_responsibilitiesstringOptionalThe scope of responsibilities for the level.
trackModelOptionalExpand Update a level — response body — track
track_idstringOptionalThe track associated with the level. Required during creation. Include global_level when changing it.
updated_atstringRequired within parentRecord update date

Referenced models: Update a level — response body — parent, Update a level — response body — track

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.