2023

2023-12-27

Improvement

Changed the offboarding.in_review webhook event name to offboarding.review_started. For more information, see the API Spec pages.

2023-12-20

Feature

Introducing Offboarding In Review Webhook Events

Introduced the offboarding.in_review webhook event. For more information, see the API Spec pages.

2023-12-19

Feature

Introducing Offboarding Submitted Webhook Events

Introduced the offboarding.submitted webhook event. For more information, see the API Spec pages.

2023-12-15

New Feature

Introduced the incentive.processing_started webhook event. For more information, see the API Spec pages.

2023-12-12

New Feature

Enhancements to Employment Creation Process

• Integration of manager > id :
  • Endpoint Update: The endpoint GET /v1/countries/:country/employment_basic_information has been enhanced to include a new fieldset: manager which returns a property called id with a list of managers that could be associated with the employment creation.
  • Usage in Employment Creation:
    • The manager field set with the id field is now available for use with the POST /v1/employments endpoint. This field allows for the association of an existing manager with the newly created employment.

2023-12-08

New Feature

Modification to the timeoff-balances endpoint

Fixes the timeoff-balancesendpoint so that the contractual_entitled field now returns an integer. This value correponds to the number of time off days for the employment, based on their contract. For more information, see the API Specs pages.

Feature

Introducing Offboarding Deleted Webhook Events

Introduced the offboarding.deleted webhook event. For more information, see the API Spec pages.

2023-12-06

Improvement

New error message showed when requesting a form that a country does not have available

When GET v1/countries/:country_code/:form is called, if the country referring to the given country_code has not available the given form then the specific error 422 message "Form not available for requested country" is returned. For more information, see the API Spec page.

2023-11-30

Improvement

Added 3 new content types for expense receipt downloads

Response content types for GET v1/expenses/{id}/receipt now include image/webp, text/csv and application/vnd.openxmlformats-officedocument.spreadsheetml.sheet. For more information, see the API Spec page.

2023-11-29

Improvement

Introducing status filter in list employments

Introduced a new query parameter for the GET v1/employments endpoint for listing employments based on the employement's status. More information on the API Spec page.

Feature

Introducing Employment User Status Activated Webhook Events

Introduced the employment.user_status.activated webhook event. For more information, see the API Spec pages.

Feature

Introducing Employment User Status Deactivated Webhook Events

Introduced the employment.user_status.deactivated webhook event. For more information, see the API Spec pages.

2023-11-27

Feature

Introducing Employment Account Updated Webhook Events

Introduced the employment.account.updated webhook event. For more information, see the API Spec pages.

2023-11-24

Feature

Introducing Contract Amendment Done Webhook Event

Introduced the contract_amendment.done webhook event. For more information, see the API Spec pages.

2023-11-22

Feature

Introducing Incentive Paid Webhook Event

Introduced the incentive.paid webhook event. For more information, see the API Spec pages.

Feature

Introducing Incentive Updated and Created Webhook Events

Introduced the incentive.updated and incentive.created webhook event. For more information, see the API Spec pages.

2023-11-21

Feature

Introducing Incentive Deleted webhook

Introduced the incentive.deleted webhook event. For more information, see the API Spec pages.

2023-11-16

Feature

Introducing Employment Details Updated webhook

Introduced the employment.details.updated webhook event. For more information, see the API Spec pages.

Feature

Introducing department field in Show Employment

Now, theShow employment endpoint also include the department field in its response.

2023-11-06

Improvement

Added a new possible value for the type key in Employment endpoints response.

Values can now be either employee, contractor, direct_employee or global_payroll_employee.

For more information, see the API Specs page.

2023-10-27

Feature

Introducing Expense Approved Webhook Events

Introduced the expense.approved webhook event. For more information, see the API Spec pages.

Feature

Introducing Expense Declined Webhook Events

Introduced the expense.declined webhook event. For more information, see the API Spec pages.

2023-10-04

Feature

Introducing Personnal Information Updated webhook

Introduced the employment.personal_information.updated webhook events. For more information, see the API Spec pages.

2023-09-26

Improvement

Introducing new schema to create and update employments
Introduced basic_information, a new body parameter for the POST v1/employments and PATCH v1/employments endpoints for creating and updating employments. Using this field instead of the root-level body parameters is highly recommended.

As with other JSON schemas used in the API, it's possible to verify the fields for the basic_information field by sending a request to the Show form schema ****endpoint and replacing the form path parameter with employment_basic_information.

More information on the API Spec page.

2023-09-21

Feature

Active employment can be updated with manager_id field and address_details , emergency_contact_details json schema.

2023-09-13

Improvement

Introducing email filter in list employments

Introduced a new query parameter for the GET v1/employments endpoint for listing employments based on the employee's personal email. This can also be useful for finding specific employment based on email. More information on the API Spec page.

2023-09-05

Feature

Introducing new sort option for outstanding payments and refunds

Introduced the sort_by field invoice_period on the /api/v1/employer/outstanding-payments-and-refunds endpoint

2023-08-24

Feature

Introducing Expense Webhook Events

Introduced the expense.deleted and expense.updated webhook events. For more information, see the API Spec pages.

Introducing Expense Receipt Download Endpoint

Introduced the GET v1/expenses/:expense_id/receipt endpoint for downloading receipt files. For more information, see the API Spec pages.

2023-08-02

Feature

Introducing a new endpoint for inviting employees

Introduced the POST v1/employments/:employment_id/invite endpoint for inviting an employee to start the self-enrollment in the Remote Platform. More information is on the API Spec page.

2023-07-26

Features

Introducing support for direct employees

Now, the List employments and Show employment endpoints also include direct_employee s in their responses. A direct_employee is a person employed directly by the employer, without the involvement of Remote's entities.

2023-07-11

Features

Introducing Offboarding Endpoints

Added 3 new endpoints for creating, listing, and reading offboarding entries for employments. These new endpoints and their HTTP methods are as follows:

• GET /offboardings: Get a list of offboarding entries for all employments in your company.
• GET /offboardings/:id: Get the offboarding entry identified with :id, for an employment in your company.
• POST /offboardings: Create an offboarding entry for an employment in your company. The employment_id is expected in the request body.

API documentation for the endpoint can be found here.

2023-06-26

Improvements

Introducing Detailed Metadata for the Contract Details - Benefits Field

Added a x-jsf-presentation keyword under the benefits field’s options in the contract_details JSON schema. The x-jsf-presentation keywords contain a meta keyword, which presents detailed information regarding the benefit option.

Previously, the benefits field only contained a label for the various benefit options, such as the following example:

"benefits": {
  "properties": {
    "health": {
      "oneOf": [
				{
				  "const": "Standard - Employee Only (Canada Life - Standard Health Employee Only; Canada Life - Standard Dental Employee Only; Canada Life - Standard Vision; Canada Life - Standard Life; Canada Life - Standard AD&D; Canada Life - Standard Short Term Disability; Canada Life - Standard Long Term Disability)",
				  "title": "Standard - Employee Only - $130.00/mo + variable costs",
				},
				{ ... another tier ... }
				{ ... another tier ... }
			]
		}
	}
}

This data significantly lacked in detail and omitted detailed information about the benefit, otherwise available through the Remote Employ platform.

With the new meta keyword, significantly more information is provided through the JSON schema:

"benefits": {
  "properties": {
    "health": {
      "oneOf": [
				{
				  "const": "Standard - Employee Only (Canada Life - Standard Health Employee Only; Canada Life - Standard Dental Employee Only; Canada Life - Standard Vision; Canada Life - Standard Life; Canada Life - Standard AD&D; Canada Life - Standard Short Term Disability; Canada Life - Standard Long Term Disability)",
				  "title": "Standard - Employee Only - $130.00/mo + variable costs",
				  "x-jsf-presentation": {
				    "description": "Medical Insurance, Drug Prescriptions, Dental Insurance, Vision Insurance, Life Insurance and AD&D Insurance (1x annual Salary), Dependant and Spouse Life, long and short term disability (66.7% weekly earnings - maximums apply).",
				    "inputType": "radio",
				    "meta": {
				      "detailsUrl": "https://remote.com/benefits-guide/employee-benefits-canada-health-standard-single",
				      "displayCost": "$130.00/mo + variable costs",
				      "displayCostDisclaimer": "Some plans in this benefit package include premium costs based on the employee salary. These costs are not included in the listed monthly estimate.",
				      "providerName": "Canada Life",
							"tierName": "Standard"
				    }
				  }
				},
				{ ... another tier ... }
				{ ... another tier ... }
			]
		}
	}
}

This meta aims to allow Remote API developers to match the Remote Employ UI as closely as possible.

Please visit the Working with Benefits guide for more details, API specs, and demo.

2023-06-14

Improvements

Improving the **Time Off Balance endpoint’s entitlement expiration date parameter**

• Added a can_expire parameter to the GET /timeoff-balances response, indicating whether a time off entitlement can expire or not.
• Improved the expiry_date parameter of the GET /timeoff-balances response. Previously, when a time off entitlement did not have an expiry date, the expiry_date parameter’s value would be "" (empty string). With this change, its value will be null.

Previously, when entitlement had no expiry date:
{
  "data": {
    "timeoff_balance": {
      "timeoff_entitlements": [
        {
          "expiry_date": "",
          ...
        },
        ...
      ],
      ...
    }
  }
}

Now, when entitlement has no expiry date:
{
  "data": {
    "timeoff_balance": {
      "timeoff_entitlements": [
        {
          "expiry_date": null,
          "can_expire": false,
          ...
        },
        ...
      ],
      ...
    }
  }
}

Other Improvements

• The default page size for paginated results was increased to 20. Previously, there was no standard for the default page size, but all default page sizes were less than 20.

2023-05-25

Introducing Employment Custom Fields Endpoints

Added new endpoints for reading employment's custom fields. These new endpoints and their HTTP methods are as follows:

• GET /custom-fields: Get the list of all custom fields created in the company.
• GET /custom-fields/:custom_field_id/values/:employment_id: Get the value of a given custom field for employment.

Please see the API docs for more details on how to interpret the response.

2023-05-04

Features

Introducing a new endpoint for Time Off Balance

Added a new endpoint for retrieving a summary of time off balance for employments. The new endpoint and its HTTP method is as follows:

GET /timeoff-balances/:employment_id

Please see the API docs for more details on how to interpret the response.

2023-04-10

Features

Added new endpoints for managing incentives for employments. These new endpoints and their HTTP methods are as follows:

One-time Incentives:

• GET /incentives: Get the list of all incentives that belongs to a company.
• POST /incentives: Create a new on-time incentive.
• GET /incentives/:id: Show an incentive, given its id.
• PUT/PATCH /incentives/:id: Update the incentive with ID :id.
• DELETE /incentives/:id: Delete an incentive that is not processing or was paid.

Recurring Incentives

• POST /incentives/recurring: Create a new monthly incentive.
• GET /incentives/recurring: Get the list of all recurring incentives that belongs to a company.
• DELETE /incentives/recurring/:id: Delete a recurring incentive, except the occurrences that are not processing or were paid.

For more information about Incentives, please check the “Working with incentives” page.

2023-03-02

Features

Webhook callbacks registered using POST /v1/webhook-callbacks will now be provided with a signing_key in the response:

{
    "data": {
        "webhook_callback": {
            "id": "fbac1e8a-3f38-4e1a-acbe-f046761171bf",
            "signing_key": "wkyzvs764ifdrpct2naqhksmq4",
            "subscribed_events": ["subscribed.event.type"],
            "url": "<Your URL>"
        }
    }
}

You can use this signing_key to authenticate webhook requests made by Remote. To this end, Remote now includes two new headers in these webhook requests sent to your callback URLs:

• X-Remote-Signature
• X-Remote-Timestamp

For more details, see this guide on how to verify signatures sent by Remote.

2023-02-28

Features

Introducing Webhooks and Webhook Events

Added 2 new endpoints for managing webhooks and 3 webhook events to subscribe when registering webhook callbacks.

The 2 new endpoints for managing webhooks are as follows:

• POST /webhook-callbacks: Register a webhook URL to be called when any one of the subscribed events take place in Remote.
• DELETE /webhook-callbacks/:id: Delete a previously registered webhook URL so it’s no longer called when the subscribed events take place in Remote.

API documentation for registering webhook URLs can be found here.

Additionally, the 3 webhook events you can subscribe are as follows:

• employment.onboarding.completed: Triggered when an employment’s onboarding is completed and there are no more documentations left to check.
• employment.onboarding_task.completed: Triggered when an employment’s onboarding task is completed.
• payslip.released: Triggered when a payslip is ready and available for an employee.

API documentation for webhook events can be found in their respective categories (Employments and Payslips).

Introducing the Payslip Download Endpoint

When the payslip.released webhook event occurs, only the ID of the payslip is included in the webhook callback request. A new endpoint has been introduced to enable downloading of payslips: GET /payslips/:payslip_id/download.

API documentation for the endpoint to download a payslip can be found here.

Introducing Expense Endpoints

Added 3 new endpoints for creating, listing, and reading expense entries for employments. These new endpoints and their HTTP methods are as follows:

• POST /expenses: Add an approved expense entry
• GET /expenses: Get a list of expense entries
• GET /expenses/:id: Get the expense entry identified with :id

API documentation for the expenses endpoint can be found here.

2023-02-08

Features

Introducing Delete Company Manager Endpoint

Added a new endpoint for deleting existing company managers. More information can be found on the API Specification page for the endpoint.

Introduced a new field for following the employment lifecycle

We introduced a new field to the Employments endpoints called employment_lifecycle_stage that makes it easier to determine the employee or contractor’s onboarding stage. It's available in the response of the following endpoints:

• Show employment
• Create employment