# Remote Employments API

**Canonical:** https://apis.io/apis/remote/remote-employments-api/  
**Provider:** Remote — https://apis.io/providers/remote/  
**Base URL:** https://gateway.remote.com/v1/  
**Documentation:** https://developer.remote.com/reference/welcome-to-remote-api

Remote Employments API is one of 14 APIs that [Remote](https://apis.io/providers/remote/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Employments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The Employments API from Remote — 53 operation(s) for employments.

## Operations (60 of 66)

| Method | Path | Summary |
|---|---|---|
| PUT | `/v2/employments/{employment_id}/pricing-plan-details` | Update pricing plan details |
| POST | `/v1/cancel-onboarding/{employment_id}` | Cancel onboarding |
| PUT | `/v2/employments/{employment_id}/address-details` | Update address details |
| GET | `/v1/employments` | List employments |
| POST | `/v1/employments` | Create employment |
| GET | `/v1/employee/bank-account` | Show employee bank account |
| PUT | `/v1/employee/bank-account` | Update employee bank account |
| GET | `/v2/employments/{employment_id}/engagement-agreement-details` | Get engagement agreement details |
| POST | `/v2/employments/{employment_id}/engagement-agreement-details` | Upsert engagement agreement details |
| GET | `/v1/employee/documents/{id}` | Download a document for the employee |
| GET | `/v1/identity-verification/{employment_id}` | Get Employment Profile |
| GET | `/v1/employments/{employment_id}/job` | Show employment job |
| DELETE | `/v1/onboarding/employments/{employment_id}/pre-onboarding-requirements/{requirement_slug}/acknowledge` | Remove a pre-onboarding acknowledgement |
| POST | `/v1/onboarding/employments/{employment_id}/pre-onboarding-requirements/{requirement_slug}/acknowledge` | Acknowledge a pre-onboarding acknowledgement requirement |
| GET | `/v1/employments/{employment_id}/background-checks/{background_check_id}` | Show Background Check |
| GET | `/v1/onboarding/employments/{employment_id}/pre-onboarding-document-requirements` | List pre-onboarding document requirements for an employment |
| GET | `/v1/employments/{employment_id}/cost-center-allocations` | List cost center allocations for an employment |
| PUT | `/v2/employments/{employment_id}/federal-taxes` | Update federal taxes |
| POST | `/v1/risk-reserve` | Create risk reserve |
| POST | `/v1/employments/{employment_id}/risk-reserve-proof-of-payments` | Submit risk reserve proof of payment |
| GET | `/v1/employee/address` | Show employee address |
| PUT | `/v1/employee/address` | Update employee address |
| GET | `/v2/employments/{employment_id}/basic-information` | Get basic information |
| PUT | `/v2/employments/{employment_id}/basic-information` | Update basic information |
| PUT | `/v1/employments/{employment_id}/federal-taxes` | Update federal taxes |
| POST | `/v1/onboarding/employments/{employment_id}/pre-onboarding-requirements/{requirement_slug}/documents` | Find or create a document for a pre-onboarding requirement |
| GET | `/v1/files/{id}` | Download file |
| POST | `/v1/identity-verification/{employment_id}/decline` | Decline Identity Verification |
| GET | `/v1/onboarding/employments/{employment_id}/pre-onboarding-documents/{id}` | Retrieve a pre-onboarding document with its rendered PDF content |
| PUT | `/v1/employee/federal-taxes` | Submit employee federal taxes |
| PUT | `/v2/employments/{employment_id}/emergency-contact` | Update emergency contact |
| PUT | `/v1/employments/{employment_id}/basic-information` | Update basic information |
| GET | `/v1/employments/{employment_id}` | Show employment |
| PATCH | `/v1/employments/{employment_id}` | Update employment |
| PUT | `/v1/employments/{employment_id}` | Update employment |
| GET | `/v1/company/{company_id}/cost-center-allocations` | List cost center allocations for a company |
| GET | `/v1/bulk-employment-jobs/{job_id}/rows` | List bulk employment rows |
| GET | `/v1/employee/emergency-contact` | Show employee emergency contact |
| PUT | `/v1/employee/emergency-contact` | Update employee emergency contact |
| PUT | `/v2/employments/{employment_id}/contract-details` | Update contract details |
| POST | `/v1/ready` | Complete onboarding |
| POST | `/v1/employments/{employment_id}/contract-origin` | Set contract origin for a contractor employment |
| GET | `/v1/employee/personal-details` | Show employee personal details |
| PUT | `/v1/employee/personal-details` | Update employee personal details |
| GET | `/v1/employments/{employment_id}/files` | List employment files |
| POST | `/v1/documents` | Upload file |
| POST | `/v1/employments/{employment_id}/invite` | Invite employment |
| PUT | `/v2/employments/{employment_id}/bank-account-details` | Update bank account details |
| GET | `/v1/employments/{employment_id}/onboarding-steps` | Show onboarding steps for an employment |
| GET | `/v1/bulk-employment-jobs/{job_id}` | Show bulk employment job |
| PATCH | `/v2/employments/{employment_id}` | Update employment |
| PUT | `/v2/employments/{employment_id}` | Update employment |
| PUT | `/v2/employments/{employment_id}/personal-details` | Update personal details |
| POST | `/v1/onboarding/employments/{employment_id}/pre-onboarding-documents` | Find or create a pre-onboarding document for an employment |
| PUT | `/v2/employments/{employment_id}/billing-address-details` | Update billing address details |
| POST | `/v1/bulk-employment-jobs` | Create bulk employment job |
| PUT | `/v1/employments/{employment_id}/personal-details` | Update personal details |
| POST | `/v1/onboarding/employments/{employment_id}/pre-onboarding-documents/{id}/sign` | Sign a pre-onboarding document |
| PUT | `/v1/employee/state-taxes/{jurisdiction}` | Submit employee state taxes |
| GET | `/v1/employments/{employment_id}/engagement-agreement-details` | Get engagement agreement details |

…and 6 more operations. They are listed in full on the page.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/remote/refs/heads/main/openapi/remote-employments-api-openapi.yml
- **Documentation** — https://developer.remote.com/docs/getting-started-with-remote
- **APIReference** — https://developer.remote.com/reference/welcome-to-remote-api

## Other Remote APIs (12)

- [Remote Benefits API](https://apis.io/apis/remote/remote-benefits-api/)
- [Remote Billing API](https://apis.io/apis/remote/remote-billing-api/)
- [Remote Companies API](https://apis.io/apis/remote/remote-companies-api/)
- [Remote Contractors API](https://apis.io/apis/remote/remote-contractors-api/)
- [Remote Contracts API](https://apis.io/apis/remote/remote-contracts-api/)
- [Remote Employee Actions API](https://apis.io/apis/remote/remote-employee-actions-api/)
- [Remote Getting Started API](https://apis.io/apis/remote/remote-getting-started-api/)
- [Remote Integrations API](https://apis.io/apis/remote/remote-integrations-api/)
- [Remote Offboarding API](https://apis.io/apis/remote/remote-offboarding-api/)
- [Remote Partner Configuration API](https://apis.io/apis/remote/remote-partner-configuration-api/)
- [Remote Pay & Compensation API](https://apis.io/apis/remote/remote-pay-compensation-api/)
- [Remote Testing & Sandbox API](https://apis.io/apis/remote/remote-testing-sandbox-api/)

## Tags

Employments

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/remote/remote-employments-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/remote/.