Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Remote Employments API

Create, read, update, and invite employment records

Remote Employments API is one of 40 APIs that Remote publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 4 JSON Schema definitions.

Tagged areas include Employments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 4 JSON Schemas.

This API exposes 7 operations across 4 paths, and defines 8 schemas. It is described by OpenAPI 3.1.0, at version 2026-05-22.

Requests are made against 2 base URLs: https://gateway.remote.com/v1, https://gateway.remote-sandbox.com/v1.

7 operations 4 paths 8 schemas 3 GET1 PATCH2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2026-05-22
Base URL
https://gateway.remote.com/v1
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Remote Employments API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). By default, every request must be authenticated.

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 3 GET, 1 PATCH, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Employments 7

Create, read, update, and invite employment records

GET
/employments
List Employments
listEmployments 7 params → 200401429
POST
/employments
Create An Employment
createEmployment body → 201400
GET
/employments/{employment_id}
Show An Employment
showEmployment 1 param → 200404
PATCH
/employments/{employment_id}
Update An Employment
updateEmployment 1 param body → 200
POST
/employments/{employment_id}/invite
Invite An Employment To Self-Serve Onboarding
inviteEmployment 1 param → 202
GET
/employments/{employment_id}/administrative_details
Show Administrative Details
showAdministrativeDetails 1 param → 200
PUT
/employments/{employment_id}/administrative_details
Update Administrative Details
updateAdministrativeDetails 1 param body → 200

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are Employment (18 properties), EmploymentCreateRequest (9 properties), EmploymentUpdateRequest (5 properties), ErrorResponse (2 properties). Each schema is shown below with its type and property counts.

EmploymentStatus
string
EmploymentLifecycleStage
string
EmploymentUpdateRequest
object
5 properties
ErrorResponse
object
2 properties
EmploymentCreateRequest
object
9 properties 4 required
EmploymentList
object
1 property
EmploymentEnvelope
object
1 property
Employment
object
18 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

remote-com-employments-api-openapi.yml Raw ↑

Other APIs Remote publishes across the network.

Remote Webhooks
Remote Benefit Offers API
Remote Benefit Renewals API
Remote Billing Documents API
Remote Companies API
Remote Company Currencies API
Remote Company Managers API
Remote Company Structure API
Remote Compliance API
Remote Contract Amendments API
Remote Contract Documents API
Remote Contract Eligibility API