Rippling: Base API schemas
21 Rippling schemas with complete fields and constraints.
← Base API operations · All schemas
GET Company Activity — base Api get Company Activity — response body — data events, next events array item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | The event model for company activity. Please note, the event type can be one of the following: - EXTERNAL_ACCONT_CREATE - EXTERNAL_ACCOUNT_INVITE - EXTERNAL_ACCOUNT_DELETE - EXTERNAL_ACCOUNT_SUSPEND - EXTERNAL_ACCOUNT_PASSWORD_RESET - EXTERNAL_GROUP_ADD - EXTERNAL_GROUP_REMOVE - EXTERNAL_GROUP_MEMBER_REMOVE - EXTERNAL_GROUP_MEMBER_ADD - EXTERNAL_SSO_GRANT - EXTERNAL_SSO_REVOKE - EXTERNAL_SSO_SIGNIN - RPASS_ITEM_SHARED - RPASS_ITEM_UNSHARED - RPASS_ITEM_USED - USER_LOGIN_SUCCESS - USER_LOGIN_FAILED - ACCOUNT_PASSWORD_RESET - ACCOUNT_PASSWORD_CHANGED - TWO_FACTOR_DEVICE_RESET |
company | string | Optional | Unique identifier for the company. |
event_reason | JSON | Optional | |
event_reason (anyOf 1) | object | Alternative | Reason for the event, tied to the type of eveent. |
event_reason (anyOf 1).message | string | Optional | Message of the event. |
event_reason (anyOf 1).reason | string | Optional | Reason for the event. |
event_reason (anyOf 2) | null | Alternative | |
event_type | string | Optional | An ENUM value for the type of the event. Known values: EXTERNAL_ACCOUNT_CREATE, EXTERNAL_ACCOUNT_INVITE, EXTERNAL_ACCOUNT_DELETE, EXTERNAL_ACCOUNT_SUSPEND, EXTERNAL_ACCOUNT_PASSWORD_RESET, EXTERNAL_GROUP_ADD, EXTERNAL_GROUP_REMOVE, EXTERNAL_GROUP_MEMBER_REMOVE, EXTERNAL_GROUP_MEMBER_ADD, EXTERNAL_SSO_GRANT, EXTERNAL_SSO_REVOKE, EXTERNAL_SSO_SIGNIN, EXTERNAL_SSO_SIGNIN_BLOCKED, RPASS_ITEM_SHARED, RPASS_ITEM_UNSHARED, RPASS_ITEM_USED, RPASS_FOLDER_SHARED, RPASS_FOLDER_UNSHARED, USER_LOGIN_SUCCESS, USER_LOGIN_FAILED, LDAP_AUTHENTICATION_SUCCESS, LDAP_AUTHENTICATION_FAILED, DEVICE_AUTHENTICATION_SUCCESS, DEVICE_AUTHENTICATION_FAILED, ACCOUNT_PASSWORD_RESET, ACCOUNT_PASSWORD_CHANGED, TWO_FACTOR_CHECK_SUCCESS, TWO_FACTOR_CHECK_FAILED, TWO_FACTOR_DEVICE_RESET, SPOKE_USER_MATCHED, SPOKE_USER_UNMATCHED, SECURITY_ADMINS_UPDATED, BDR_POLICY_UPDATED, AUTH_RULE_UPDATED, COMPANY_AUTH_RULE_UPDATED, ACCESS_TOKEN_EXPIRED, INBOUND_SSO_SIGN_IN, SP_INIT_SIGN_IN, EMAIL_VERIFICATION_INITIATED, PHONE_VERIFICATION_INITIATED, EMAIL_VERIFICATION_SUCCEEDED, PHONE_VERIFICATION_SUCCEEDED, EMAIL_VERIFICATION_FAILED, PHONE_VERIFICATION_FAILED, GROUP_ACCESS_CHANGED, ROLE_ATTRIBUTE_CHANGED, SCHEDULED_CHANGE_CREATED, BEHAVIOUR_DETECTION_TEST, RULE_CHANGED, ADDED_TO_INCLUSION, REMOVED_FROM_INCLUSION, ADDED_TO_POST_ROLE_STATE_INCLUSION, REMOVED_FROM_POST_ROLE_STATE_INCLUSION, ADDED_TO_TERMINATED_INCLUSION, REMOVED_FROM_TERMINATED_INCLUSION, ADDED_TO_EXCLUSION, REMOVED_FROM_EXCLUSION, EXCLUSION_RULE_CHANGED, ROLE_STATE_CHANGED, MANAGER_CHANGED, DEPARTMENT_CHANGED, LEVEL_CHANGED, ADDED_TO_TEAM, REMOVED_FROM_TEAM, JOB_UPDATED, LOCATION_CHANGED, EMPLOYMENT_TYPE_CHANGED |
id | string | Optional | Unique identifier of the event. |
initiator | JSON | Optional | |
initiator (anyOf 1) | Model | Alternative | Expand GET Company Activity — baseApi.getCompanyActivity — response body — data / events, next / events / array / item / initiator / type: ROLE, SYSTEM, EXTERNAL |
initiator (anyOf 2) | null | Alternative | |
linked_events | array | Optional | An array of event identifiers that are linked to the event. |
linked_events[] | string | Each item | |
name | string | Optional | Display name for the event, tied to the type of event. |
request_data | JSON | Optional | |
request_data (anyOf 1) | Model | Alternative | Expand GET Company Activity — base Api get Company Activity — response body — data events, next events array item request data city, country, ip, latitude, longitude |
request_data (anyOf 2) | null | Alternative | |
spoke | JSON | Optional | |
spoke (anyOf 1) | string | Alternative | Unique identifier for the external application for which the event was recorded. This will be Null for events that don't correspond to an external appliction (e.g. Rippling system and RPass events). |
spoke (anyOf 2) | null | Alternative | |
subjects | array | Optional | The list of objects of the event. |
subjects[] | JSON | Each item | |
subjects[] (anyOf 1) | object | Alternative | |
subjects[] (anyOf 1).display_name | string | Optional | Name used within Rippling. |
subjects[] (anyOf 1).icon | JSON | Optional | |
subjects[] (anyOf 1).icon (anyOf 1) | string | Alternative | Icon used within Rippling. |
subjects[] (anyOf 1).icon (anyOf 2) | null | Alternative | |
subjects[] (anyOf 1).instance | string | Optional | Unique key for the event object. |
subjects[] (anyOf 1).type | string | Optional | An ENUM value for the type of object. Known values: ROLE, SPOKE, RPASS_ITEM, SPOKE_USER, GROUP |
subjects[] (anyOf 2) | null | Alternative | |
timestamp | string | Optional | Timestamp at which the event was recorded. |
Referenced models: GET Company Activity — baseApi.getCompanyActivity — response body — data / events, next / events / array / item / initiator / type: ROLE, SYSTEM, EXTERNAL, GET Company Activity — base Api get Company Activity — response body — data events, next events array item request data city, country, ip, latitude, longitude
GET Company Activity — base Api get Company Activity — response body — data events, next events array item request data city, country, ip, latitude, longitude
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Geographic details from where the event was recorded. |
city | string | Optional | City the event was triggered from. |
country | string | Optional | Country the event was triggered from. |
ip | string | Optional | Event IP addresss. |
latitude | string | Optional | Latitude the event was triggered from. |
longitude | string | Optional | Longitude the event was triggered from. |
GET Company Activity — baseApi.getCompanyActivity — response body — data / events, next / events / array / item / initiator / type: ROLE, SYSTEM, EXTERNAL
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | The actor of the event. |
display_name | string | Optional | The name used within Rippling. |
icon | JSON | Optional | |
icon (anyOf 1) | string | Alternative | The icon used within Rippling. |
icon (anyOf 2) | null | Alternative | |
role | JSON | Optional | |
role (anyOf 1) | string | Alternative | A unique identifier for the employee that initiated the action, if the type is ROLE. |
role (anyOf 2) | null | Alternative | |
type | string | Optional | ENUM value for the type of actor. Known values: ROLE, SYSTEM, EXTERNAL |
GET Company Leave Types — response body — item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Company leave request object |
description | string | Optional | |
id | string | Optional | Unique identifier of the company leave request |
isUnpaid | boolean | Optional | Is leave type unpaid |
leaveType | string | Optional | Company leave type key |
name | string | Optional | Company leave type name |
GET Current Company — base Api get Companies — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A company object as represented within Rippling. |
address | JSON | Optional | |
address (anyOf 1) | Model | Alternative | Expand GET Current Company — base Api get Companies — response body — address An address object as stored within Rippling |
address (anyOf 2) | null | Alternative | |
entities | Model | Optional | Expand GET Current Company — base Api get Companies — response body — entities |
id | string | Optional | |
name | string | Optional | |
phone | string | Optional | |
primaryEmail | string | Optional | |
workLocations | array | Optional | |
workLocations[] | Model | Each item | Expand GET Work Locations — response body — item |
Referenced models: GET Current Company — base Api get Companies — response body — entities, GET Work Locations — response body — item, GET Current Company — base Api get Companies — response body — address An address object as stored within Rippling
GET Current Company — base Api get Companies — response body — address An address object as stored within Rippling
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | An address object as stored within Rippling. |
city | string | Optional | |
country | string | Optional | |
isRemote | boolean | Optional | |
phone | string | Optional | |
state | string | Optional | |
steLocationCode | object | Optional | |
steLocationCode.cityCode | string | Optional | |
steLocationCode.countyCode | string | Optional | |
steLocationCode.isOverridden | string | Optional | |
steLocationCode.locationCode | string | Optional | |
steLocationCode.municipalityCode | string | Optional | |
steLocationCode.psdCode | string | Optional | |
steLocationCode.schoolCode | string | Optional | |
steLocationCode.stateCode | string | Optional | |
steLocationCode.transitDistrictCode | string | Optional | |
streetLine1 | string | Optional | |
streetLine2 | string | Optional | |
zip | string | Optional |
GET Current Company — base Api get Companies — response body — entities
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | This model represents the legal entities inside of a given company. Legal entities based in Canada (CA) are currently supported at this time. |
CA | array | Optional | CA represents Canada. |
CA[] | object | Each item | |
CA[].entityInfo | object | Optional | |
CA[].entityInfo.businessNumber | string | Optional | The Canada Business Number |
CA[].entityInfo.legalName | string | Optional | The legal name of the entity |
CA[].id | string | Optional | The unique Rippling ID of the legal entity |
CA[].isEor | boolean | Optional | If set to true, the legal entity is Rippling's EOR. If set to false, the legal entity is not on Rippling's EOR. |
GET Current User — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Information about the Rippling user whose token is being used to access Rippling's API. |
company | string | Optional | Unique identifier of the company. |
id | string | Optional | Unied identifier of the user (likely an admin). |
workEmail | string | Optional | Work email of the user. |
GET Custom Fields — response body — item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A Custom Fields object within Rippling. |
Id | string | Optional | The identifier of the specific custom field. |
required | boolean | Optional | Denotes whether the custom field is or is not mandatory |
title | string | Optional | The title of the custom field. |
type | string | Optional | Denotes the type of the custom field. Known values: TEXT, DATE, NUMBER, CURRENCY, PERCENTAGE, SELECT, FILE, ID, RADIO, TEXTAREA |
GET Employee — base Api get Employees Employee Id — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | An employee model object. |
customFields | Model | Optional | Expand GET Employee — base Api get Employees Employee Id — response body — custom Fields |
department | string | Optional | The employee's department name |
employeeNumber | string | Optional | This indicates the sequential employee number within their company. This number continues to grow as each employee is onboarded. i.e if you are the 65th employee to join the company with 32 active employees, the employeeNumber would be 65. |
employmentType | string | Optional | An ENUM of employment type. Will default to one of these six values unless the employee's profile has a job display name configured. Known values: CONTRACTOR, SALARIED_FT, SALARIED_PT, HOURLY_FT, HOURLY_PT, TEMP |
endDate | JSON | Optional | |
endDate (anyOf 1) | string | Alternative | The employee's end date |
endDate (anyOf 2) | null | Alternative | |
firstName | string | Optional | First name of the employee |
gender | JSON | Optional | |
gender (anyOf 1) | string | Alternative | The employee's gender Known values: MALE, FEMALE |
gender (anyOf 2) | null | Alternative | |
id | string | Optional | This is the unique role ID of the employee. A role ID exists per 1 and only 1 company. |
identifiedGender | JSON | Optional | |
identifiedGender (anyOf 1) | string | Alternative | The employee's identified gender Known values: MALE, FEMALE, NONBINARY |
identifiedGender (anyOf 2) | null | Alternative | |
isInternational | boolean | Optional | Whether the employee is an international employee or not. |
isManager | boolean | Optional | Whether the employee is a manger |
isRemote | boolean | Optional | Whether the employee's job is remote |
lastName | string | Optional | Last name of the employee |
level | string | Optional | The level of the employee |
manager | JSON | Optional | |
manager (anyOf 1) | string | Alternative | The unique identifier of the employee's manager. This value can be null. |
manager (anyOf 2) | null | Alternative | |
name | string | Optional | Full name of the employee |
photo | string | Optional | The photo of the employee stored in Rippling |
preferredFirstName | string | Optional | |
preferredLastName | string | Optional | |
roleState | string | Optional | The employee's role status - roleState meanings: INIT: An initial record of an individual. An offer has not been made and they have not started working at the company. HIRED: An offer has been made but they have not accepted or started yet. ACCEPTED: An offer has been made and they have accepted, but they have not started yet. ACTIVE: The employee currently works at the company and their start date is today or in the past. TERMINATED: The employee is no longer active. Known values: INIT, HIRED, ACCEPTED, ACTIVE, TERMINATED |
smallPhoto | string | Optional | The small photo of the employee stored in Rippling |
spokeId | JSON | Optional | |
spokeId (anyOf 1) | string | Alternative | |
spokeId (anyOf 2) | null | Alternative | |
teams | array | Optional | An array of the teams that the employee is on |
teams[] | JSON | Each item | |
title | string | Optional | The employee's work title |
userId | string | Optional | This is the unique user ID of the employee. A userID can span across 1 or many companies. |
workEmail | JSON | Optional | |
workEmail (anyOf 1) | string | Alternative | The employee's work email |
workEmail (anyOf 2) | null | Alternative | |
workLocation | JSON | Optional | |
workLocation (anyOf 1) | Model | Alternative | Expand GET Current Company — base Api get Companies — response body — address An address object as stored within Rippling |
workLocation (anyOf 2) | null | Alternative | |
workSchedule | object | Optional | The employee's weekly work schedule |
worklocationNickname | string | Optional | The work location nickname |
Referenced models: GET Employee — base Api get Employees Employee Id — response body — custom Fields, GET Current Company — base Api get Companies — response body — address An address object as stored within Rippling
GET Employee — base Api get Employees Employee Id — response body — custom Fields
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
customFieldTitle1 | string | Optional | |
customFieldTitleN | string | Optional |
GET Group — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | This payload should be used when updating existing groups. |
name | string | Optional | The name of the Group. |
spokeId | string | Optional | The external identifier of the Group. |
users | array | Optional | The array of users within the Group. |
users[] | JSON | Each item | |
version | string | Optional | The version identifier of the Group. |
GET Group — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
id | string | Optional | |
name | string | Optional | User-readable name of a Rippling group. |
spokeId | JSON | Optional | |
spokeId (anyOf 1) | string | Alternative | Your id for the group; this should a unique string identifier. |
spokeId (anyOf 2) | null | Alternative | |
users | array | Optional | An array of employee Rippling ids. |
users[] | string | Each item | |
version | string | Optional | The version unique identifier of the group. |
GET Leave Balance — response body — balances Leave balances object
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Leave balances object |
| string | Optional | |
balanceWithFutureRequests | JSON | Optional | |
balanceWithFutureRequests (anyOf 1) | number | Alternative | The remaining balance in minutes for the employee corresponding to the company leave type with future leave requests considered. |
balanceWithFutureRequests (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
balanceWithoutFutureRequests | JSON | Optional | |
balanceWithoutFutureRequests (anyOf 1) | number | Alternative | The remaining balance in minutes for the employee corresponding to the company leave type with future leave requests not considered. |
balanceWithoutFutureRequests (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
companyLeaveType | string | Optional | This is the unique role ID of the company leave types. Corresponds to the ids in response of GET Company Leave Types |
isBalanceUnlimited | boolean | Optional | true if employee's balance corresponding to the company leave type is unlimited, else false |
GET Leave Requests — response body — item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Leave request object. |
comments | JSON | Optional | |
comments (anyOf 1) | string | Alternative | |
comments (anyOf 2) | null | Alternative | |
createdAt | string | Optional | |
dates | array | Optional | |
dates[] | object | Each item | |
dates[].date | string | Optional | Format: date |
dates[].numMinutes | JSON | Optional | |
dates[].numMinutes (anyOf 1) | integer | Alternative | |
dates[].numMinutes (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
endDate | string | Optional | |
endDateCustomHours | JSON | Optional | |
endDateCustomHours (anyOf 1) | JSON | Alternative | |
endDateCustomHours (anyOf 1) (anyOf 1) | string | Alternative | |
endDateCustomHours (anyOf 1) (anyOf 2) | null | Alternative | |
endDateCustomHours (anyOf 2) | JSON | Alternative | |
endDateCustomHours (anyOf 2) (anyOf 1) | number | Alternative | |
endDateCustomHours (anyOf 2) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
endDateEndTime | JSON | Optional | |
endDateEndTime (anyOf 1) | string | Alternative | |
endDateEndTime (anyOf 2) | null | Alternative | |
id | string | Optional | Unique identifier of the leave request. |
isPaid | boolean | Optional | If the leave request is paid this will be TRUE. Otherwise, this will be FALSE. |
leavePolicy | string | Optional | |
leaveTypeUniqueId | string | Optional | Known values: VACATION, SICK, JURY_DUTY |
managedBy | string | Optional | This indicates the system that manages the Leave Request. PTO = managed by Rippling's Time Off app. LEAVES = managed by Rippling's Leave Management app. TILT = managed by third-party partner Tilt. Known values: PTO, LEAVES, TILT |
numHours | JSON | Optional | |
numHours (anyOf 1) | JSON | Alternative | |
numHours (anyOf 1) (anyOf 1) | integer | Alternative | |
numHours (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
numHours (anyOf 2) | null | Alternative | |
numMinutes | JSON | Optional | |
numMinutes (anyOf 1) | JSON | Alternative | |
numMinutes (anyOf 1) (anyOf 1) | integer | Alternative | |
numMinutes (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
numMinutes (anyOf 2) | null | Alternative | |
partialDays | array | Optional | |
partialDays[] | JSON | Each item | |
partialDays[] (anyOf 1) | object | Alternative | |
partialDays[] (anyOf 1).numMinutes | JSON | Optional | |
partialDays[] (anyOf 1).numMinutes (anyOf 1) | integer | Alternative | |
partialDays[] (anyOf 1).numMinutes (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
partialDays[] (anyOf 1).partialDay | string | Optional | Format: date |
partialDays[] (anyOf 2) | null | Alternative | |
policyDisplayName | string | Optional | |
processedAt | JSON | Optional | |
processedAt (anyOf 1) | string | Alternative | |
processedAt (anyOf 2) | null | Alternative | |
processedBy | JSON | Optional | |
processedBy (anyOf 1) | string | Alternative | Unique identifier of the employee who approved or rejected the request. This may be null. |
processedBy (anyOf 2) | null | Alternative | |
processedByName | JSON | Optional | |
processedByName (anyOf 1) | string | Alternative | |
processedByName (anyOf 2) | null | Alternative | |
reasonForLeave | JSON | Optional | |
reasonForLeave (anyOf 1) | string | Alternative | |
reasonForLeave (anyOf 2) | null | Alternative | |
requestedBy | JSON | Optional | |
requestedBy (anyOf 1) | string | Alternative | |
requestedBy (anyOf 2) | null | Alternative | |
requestedByName | JSON | Optional | |
requestedByName (anyOf 1) | string | Alternative | Unique identifier of the employee who made the request (in most cases this is the same as role). |
requestedByName (anyOf 2) | null | Alternative | |
role | string | Optional | Unique identifier of the employee who is taking leave. |
roleName | string | Optional | |
roleTimezone | JSON | Optional | |
roleTimezone (anyOf 1) | string | Alternative | Timezone of the role. This will be work location timezone, or home timezone for employees without a work location. |
roleTimezone (anyOf 2) | null | Alternative | |
startDate | string | Optional | |
startDateCustomHours | JSON | Optional | |
startDateCustomHours (anyOf 1) | JSON | Alternative | |
startDateCustomHours (anyOf 1) (anyOf 1) | string | Alternative | |
startDateCustomHours (anyOf 1) (anyOf 2) | null | Alternative | |
startDateCustomHours (anyOf 2) | JSON | Alternative | |
startDateCustomHours (anyOf 2) (anyOf 1) | number | Alternative | |
startDateCustomHours (anyOf 2) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
startDateStartTime | JSON | Optional | |
startDateStartTime (anyOf 1) | string | Alternative | |
startDateStartTime (anyOf 2) | null | Alternative | |
status | string | Optional | Known values: PENDING, APPROVED, REJECTED, CANCELED |
updatedAt | string | Optional |
GET Levels — response body — item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Levels enable for self-defined,company-wide position levels, such as Manager, Engineering Manager, Executive, etc. |
id | string | Optional | Unique identifier of the level. |
name | string | Optional | Name of the level. |
parent | JSON | Optional | |
parent (anyOf 1) | string | Alternative | The unique identifier of the parent level. |
parent (anyOf 2) | null | Alternative |
GET Teams — response body — item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A team is a self-defined group of employees within Rippling. |
id | string | Optional | The identifier of the team. |
name | string | Optional | The name of the team. |
parent | JSON | Optional | |
parent (anyOf 1) | string | Alternative | The parent team (if this team is a subteam within a larger team). |
parent (anyOf 2) | null | Alternative |
GET Work Locations — response body — item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A work location object. |
address | JSON | Optional | |
address (anyOf 1) | Model | Alternative | Expand GET Current Company — base Api get Companies — response body — address An address object as stored within Rippling |
address (anyOf 2) | null | Alternative | |
id | string | Optional | |
nickname | string | Optional |
Referenced models: GET Current Company — base Api get Companies — response body — address An address object as stored within Rippling
POST Cancel Leave Request — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Leave request object. |
comments | JSON | Optional | |
comments (anyOf 1) | string | Alternative | |
comments (anyOf 2) | null | Alternative | |
createdAt | string | Optional | |
dates | array | Optional | |
dates[] | object | Each item | |
dates[].date | string | Optional | Format: date |
dates[].numMinutes | JSON | Optional | |
dates[].numMinutes (anyOf 1) | integer | Alternative | |
dates[].numMinutes (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
endDate | string | Optional | |
endDateCustomHours | JSON | Optional | |
endDateCustomHours (anyOf 1) | string | Alternative | |
endDateCustomHours (anyOf 2) | null | Alternative | |
endDateEndTime | JSON | Optional | |
endDateEndTime (anyOf 1) | string | Alternative | |
endDateEndTime (anyOf 2) | null | Alternative | |
id | string | Optional | Unique identifier of the leave request. |
isPaid | boolean | Optional | If the leave request is paid this will be TRUE. Otherwise, this will be FALSE. |
leavePolicy | string | Optional | |
leaveTypeUniqueId | string | Optional | Known values: VACATION, SICK, JURY_DUTY |
managedBy | string | Optional | This indicates the system that manages the Leave Request. PTO = managed by Rippling's Time Off app. LEAVES = managed by Rippling's Leave Management app. TILT = managed by third-party partner Tilt. Known values: PTO, LEAVES, TILT |
numHours | JSON | Optional | |
numHours (anyOf 1) | JSON | Alternative | |
numHours (anyOf 1) (anyOf 1) | integer | Alternative | |
numHours (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
numHours (anyOf 2) | null | Alternative | |
numMinutes | JSON | Optional | |
numMinutes (anyOf 1) | JSON | Alternative | |
numMinutes (anyOf 1) (anyOf 1) | integer | Alternative | |
numMinutes (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
numMinutes (anyOf 2) | null | Alternative | |
partialDays | array | Optional | |
partialDays[] | JSON | Each item | |
partialDays[] (anyOf 1) | object | Alternative | |
partialDays[] (anyOf 1).numMinutes | JSON | Optional | |
partialDays[] (anyOf 1).numMinutes (anyOf 1) | integer | Alternative | |
partialDays[] (anyOf 1).numMinutes (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
partialDays[] (anyOf 1).partialDay | string | Optional | Format: date |
partialDays[] (anyOf 2) | null | Alternative | |
policyDisplayName | string | Optional | |
processedAt | JSON | Optional | |
processedAt (anyOf 1) | string | Alternative | |
processedAt (anyOf 2) | null | Alternative | |
processedBy | JSON | Optional | |
processedBy (anyOf 1) | string | Alternative | Unique identifier of the employee who approved or rejected the request. This may be null. |
processedBy (anyOf 2) | null | Alternative | |
processedByName | JSON | Optional | |
processedByName (anyOf 1) | string | Alternative | |
processedByName (anyOf 2) | null | Alternative | |
reasonForLeave | JSON | Optional | |
reasonForLeave (anyOf 1) | string | Alternative | |
reasonForLeave (anyOf 2) | null | Alternative | |
requestedBy | JSON | Optional | |
requestedBy (anyOf 1) | string | Alternative | |
requestedBy (anyOf 2) | null | Alternative | |
requestedByName | JSON | Optional | |
requestedByName (anyOf 1) | string | Alternative | Unique identifier of the employee who made the request (in most cases this is the same as role). |
requestedByName (anyOf 2) | null | Alternative | |
role | string | Optional | Unique identifier of the employee who is taking leave. |
roleName | string | Optional | |
roleTimezone | JSON | Optional | |
roleTimezone (anyOf 1) | string | Alternative | Timezone of the role. This will be work location timezone, or home timezone for employees without a work location. |
roleTimezone (anyOf 2) | null | Alternative | |
startDate | string | Optional | |
startDateCustomHours | JSON | Optional | |
startDateCustomHours (anyOf 1) | string | Alternative | |
startDateCustomHours (anyOf 2) | null | Alternative | |
startDateStartTime | JSON | Optional | |
startDateStartTime (anyOf 1) | string | Alternative | |
startDateStartTime (anyOf 2) | null | Alternative | |
status | string | Optional | Known values: PENDING, APPROVED, REJECTED, CANCELED |
updatedAt | string | Optional |
POST New Candidate — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | The Rippling candidate model. |
attachments | array | Optional | |
attachments[] | object | Each item | An array of json objects containing file names and public file URLs containing documents pertaining to the candidate. |
attachments[].file_name | string | Optional | The file name. |
attachments[].file_url | string | Optional | The public URL and name of a pdf/docx/doc/odt file containing documents pertaining to the candidate. |
candidateId | string | Optional | The unique identifier of the candidate from the ATS. |
currency | string | Optional | A string field of the official currency as listed in ISO 4217. |
department | string | Optional | This is the id of the department from GET/departments. |
email | string | Optional | The candidate's email. |
employmentType | string | Optional | An ENUM of employment type. Will default to one of these six values unless the employee's profile has a job display name configured. One of: CONTRACTOR, SALARIED_PT, SALARIED_FT, HOURLY_FT, HOURLY_PT, TEMP |
equityShares | integer | Optional | The number of shares that will be given to the candidate. |
jobTitle | string | Optional | The candidate's job title. |
name | string | Optional | The candidate's name. |
phoneNumber | string | Optional | The candidate's phone number. |
salaryPerUnit | number | Optional | The decimal value that the candidate gets paid every salaryUnit time period. |
salaryUnit | string | Optional | An ENUM string value, denoting the frequency at which the candidate should be paid once the role begins. Note, the PAY_PERIOD ENUM implies the candidate is paid as per a custom pay period. One of: HOUR, DAY, WEEK, MONTH, PAY_PERIOD |
signingBonus | number | Optional | The bonus cash given to the candidate as a part of a one time payment, with two decimal digit precision. Format: double |
startDate | string | Optional | The would-be start date of the candidate. Format: date |
workLocation | string | Optional | This is the id of the worklocation from GET/work_locations. |
POST New Candidate — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | The Rippling candidate model. |
attachments | array | Optional | |
attachments[] | object | Each item | An array of json objects containing file names and public file URLs containing documents pertaining to the candidate. |
attachments[].file_name | string | Optional | The file name. |
attachments[].file_url | string | Optional | The public URL and name of a pdf/docx/doc/odt file containing documents pertaining to the candidate. |
candidateId | string | Optional | The unique identifier of the candidate from the ATS. |
currency | string | Optional | A string field of the official currency as listed in ISO 4217. |
department | string | Optional | This is the id of the department from GET/departments. |
email | string | Optional | The candidate's email. |
employmentType | string | Optional | An ENUM of employment type. Will default to one of these six values unless the employee's profile has a job display name configured. Known values: CONTRACTOR, SALARIED_PT, SALARIED_FT, HOURLY_FT, HOURLY_PT, TEMP |
equityShares | JSON | Optional | |
equityShares (anyOf 1) | integer | Alternative | The number of shares that will be given to the candidate. |
equityShares (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
jobTitle | string | Optional | The candidate's job title. |
name | string | Optional | The candidate's name. |
phoneNumber | string | Optional | The candidate's phone number. |
salaryPerUnit | JSON | Optional | |
salaryPerUnit (anyOf 1) | number | Alternative | The decimal value that the candidate gets paid every salaryUnit time period. |
salaryPerUnit (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
salaryUnit | string | Optional | An ENUM string value, denoting the frequency at which the candidate should be paid once the role begins. Note, the PAY_PERIOD ENUM implies the candidate is paid as per a custom pay period. Known values: HOUR, DAY, WEEK, MONTH, PAY_PERIOD |
signingBonus | JSON | Optional | |
signingBonus (anyOf 1) | number | Alternative | The bonus cash given to the candidate as a part of a one time payment, with two decimal digit precision. Format: double |
signingBonus (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
startDate | string | Optional | The would-be start date of the candidate. Format: date |
workLocation | string | Optional | This is the id of the worklocation from GET/work_locations. |