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 Companies API

Create, retrieve, and update company records

Remote Companies 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 Companies. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 4 JSON Schemas.

This API exposes 6 operations across 4 paths, and defines 10 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.

6 operations 4 paths 10 schemas 4 GET1 PATCH1 POST

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 Companies API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). By default, every request must be authenticated.

Paths & Operations 6

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

Companies 6

Create, retrieve, and update company records

GET
/companies
List Companies
listCompanies 2 params → 200401429
POST
/companies
Create A Company
createCompany body → 201400401429
GET
/companies/{company_id}
Show A Company
showCompany 1 param → 200404
PATCH
/companies/{company_id}
Update A Company
updateCompany 1 param body → 200400404
GET
/companies/{company_id}/legal_entities
List Company Legal Entities
listCompanyLegalEntities 1 param → 200
GET
/forms/{form_type}
Show A JSON Schema Form
showSchemaForm 1 param → 200

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are Company (12 properties), Address (6 properties), CompanyCreateRequest (6 properties), CompanyUpdateRequest (4 properties). Each schema is shown below with its type and property counts.

CompanyUpdateRequest
object
4 properties
CompanyCreateRequest
object
6 properties 2 required
Address
object
6 properties
CompanyEnvelope
object
1 property
LegalEntity
object
4 properties
LegalEntityList
object
1 property
Company
object
12 properties 3 required
CompanyCreateResponse
object
1 property
ErrorResponse
object
2 properties 1 required
CompanyList
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

remote-com-companies-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 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
Remote Contractor Currencies API