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 Company Management API

The Company Management API from Remote — 4 operation(s) for company management.

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

Tagged areas include Company Management. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 7 operations across 4 paths, and defines 26 schemas. It is described by OpenAPI 3.0.0, at version 0.1.0.

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

7 operations 4 paths 26 schemas 4 GET1 PATCH1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
0.1.0
Base URL
https://gateway.remote.com/v1/
Authentication
HTTP Basic, HTTP Bearer, HTTP Bearer, OAuth 2.0, OAuth 2.0, OAuth 2.0, OAuth 2.0
Resource Areas
1

Authentication & Security 7

Remote Company Management API declares 7 security schemes for authenticating requests. It accepts HTTP basic authentication (BasicAuth). It accepts HTTP bearer tokens (ClientToken). It accepts HTTP bearer tokens (CustomerAPIToken). It supports OAuth 2.0 (OAuth2) using the authorizationCode and clientCredentials flows, exposing 77 scopes. It supports OAuth 2.0 (OAuth2Assertion) using the clientCredentials flow, exposing 21 scopes. It supports OAuth 2.0 (OAuth2AuthorizationCode) using the authorizationCode flow, exposing 73 scopes. It supports OAuth 2.0 (OAuth2ClientCredentials) using the clientCredentials flow, exposing 18 scopes. By default, every request must be authenticated.

  • BasicAuth — Authenticate using the basic authentication for partners. Use the CLIENTID as login and CLIENTSECRET as password.
  • ClientToken — Authenticate a partner using only the the provided clienttoken. This authentication method only allows accessing marketing endpoints.
  • CustomerAPIToken — Authenticate using API Key generated by the customer in their Integration Settings page.
  • OAuth2 — Authenticate using OAuth 2.0 protocol.
  • OAuth2Assertion — Authenticate as the employee using the urn:ietf:params:oauth:grant-type:jwt-bearer grant in the OAuth2 protocol.
  • OAuth2AuthorizationCode — Authenticate as the token authorizer using authorizationcode / refreshtoken grants in the OAuth 2.0 protocol.
  • OAuth2ClientCredentials — Authenticate using clientcredentials grant in the OAuth 2.0 protocol.

Paths & Operations 7

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

Company Management 7
GET
/v1/companies/schema
Show form schema
get_v1_companies_schema 3 params → 200401404422
GET
/v1/companies/{company_id}
Show a company
get_v1_companies_company_id 2 params → 200400401404422429
PATCH
/v1/companies/{company_id}
Update a company
patch_v1_companies_company_id (2) 4 params body → 200400401404422429
PUT
/v1/companies/{company_id}
Update a company
patch_v1_companies_company_id 4 params body → 200400401404422429
GET
/v1/companies/{company_id}/actions
List a company's pending actions
get_v1_companies_company_id_actions 1 param → 200400401404422429
GET
/v1/companies
List all companies
get_v1_companies 2 params → 200401404422
POST
/v1/companies
Create a company
post_v1_companies 6 params body → 201400403409422429

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are Company (18 properties), CreateCompanyParams (13 properties), UpdateCompanyParams (8 properties), CompanyNotEligibleForCreationErrorResponse (4 properties). Each schema is shown below with its type and property counts.

ParameterError
object
3 properties 3 required
CompanyNotEligibleForCreationErrorResponse
object
Error returned when the company already have employees in countries supported by the integration.
4 properties
CompanyWithTokensResponse
object
Shows a company with its refresh and access tokens. Please contact Remote if you need the tokens when creating a company.
2 properties
CompanyActionsResponse
object
Lists a company's pending actions
1 property 1 required
RefreshTokenResponse
object
UnauthorizedResponse
object
Returned when the request does not include valid authentication credentials. Ensure you are passing a valid OAuth2 access token or API token in the Authorizati…
1 property 1 required
CompanyAction
object
A pending company-level action (e.g. for Contractor Management Review-step banners).
3 properties 2 required
CompanyCreationConflictErrorResponse
object
1 property
UnprocessableEntityResponse
object
BadRequestResponse
object
Returned when the request is malformed or contains invalid parameters. The message may be a simple string or a structured object with a code and detailed messa…
ActionError
object
3 properties 3 required
ClientCredentialsResponse
object
BaseTokenResponse
object
3 properties
ForbiddenResponse
object
Returned when the authenticated user or token does not have permission to perform the requested action. Check that the token has the required OAuth2 scopes and…
1 property 1 required
NotFoundResponse
object
Returned when the requested resource does not exist or is not accessible with the current authentication credentials.
1 property
CompanyAlreadyExistsErrorResponse
object
Error returned when a company with matching criteria already exists
4 properties
CompanyCreationResponse
object
1 property
CompanyFormResponse
object
Object with required and optional fields, its descriptions and suggested presentation
1 property
OAuth2Tokens
object
CompaniesResponse
object
Shows a list of companies
1 property
CompanyResponse
object
Shows a company
1 property 1 required
AuthorizationCodeResponse
object
CreateCompanyParams
object
13 properties 6 required
UpdateCompanyParams
object
8 properties
TooManyRequestsResponse
object
Returned when the API rate limit has been exceeded (HTTP 429). Wait before retrying. Check the Retry-After response header for the recommended wait time.
1 property
Company
object
18 properties 12 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

remote-company-management-api-openapi.yml Raw ↑

Other APIs Remote publishes across the network.

Remote Address Details API
Remote Administrative Details API
Remote Background Checks API
Remote Bank Account Details API
Remote Basic Information API
Remote Benefit Offers API
Remote Benefit Offers By Employment API
Remote Benefit Renewals API
Remote Benefits API
Remote Billing Address Details API
Remote Billing API
Remote Billing Documents API