Company statuses

To activate a company, it is mandatory to include the address details schema in the payload, along with a few other required parameters, which are outlined here.

However, company activation does not immediately grant permission to start hiring. Depending on the country where the company is based, the country where they intend to hire, and the nature of the business, Remote may require additional documentation, payment reserves, or further details. These requirements are detailed on the EOR Hiring Eligibility page.

Remote also provides an option for customers to directly wire payments to Remote’s account, eliminating the need for billing details during the company activation process.

The company’s active status can be verified either in the company creation response or by checking the "Show Company" endpoint.

Partners can also subscribe to the company.activated event to listen for this activation.

To retrieve the address_details schema for a specific country, you can use this endpoint.

**/v1/companies/schema?country_code=GBR&form=address_details**

{
    "data": {
        "company": {
            "id": "503026b9-3ee2-4ca5-b76b-2056191912cd",
            "name": "redance2",
            "status": "active",
            "updated_at": "2024-08-29T09:14:11",
            "external_id": null,
            "created_at": "2024-08-29T09:11:22",
            "country_code": "GBR",
            "phone_number": "2403606584",
            "bank_account_details": null,
            "tax_number": "14521452",
            "registration_number": null,
            "desired_currency": "GBP",
            "company_owner_email": "mohit.mahindroo+redance2@remote.com",
            "company_owner_name": "redance2",
            "address_details": {
                "address": "1509 Broderick St",
                "city": "London",
                "postal_code": "SW79 8SY"
            },
            "terms_of_service_accepted_at": "2024-08-29T09:11:21Z"
        }
    }
}

{
    "data": {
        "tokens": {
            "refresh_token": "7e70ace6-385......",
            "expires_in": 3600,
            "access_token": "9KvqD4o........"
        },
        "company": {
            "id": "3b8da86f-6114-443c-a1c0-9ef....",
            "name": "Partner_Custompany",
            "status": "active",
            "updated_at": "2024-08-02T23:19:40",
            "external_id": null,
            "created_at": "2024-08-02T23:19:39",
            "country_code": "GBR",
            "phone_number": "2403606588",
            "bank_account_details": null,
            "tax_number": "7984465",
            "registration_number": null,
            "desired_currency": "GBP",
            "company_owner_email": "mohit.mahindroo+sampartcustomer@remote.com",
            "company_owner_name": "John Pustomer",
            "address_details": {
                "address": "1709 Broderick St",
                "address_line_2": "Flat number 123",
                "city": "London",
                "postal_code": "SW79 8SY"
            },
            "terms_of_service_accepted_at": "2024-08-02T23:19:38Z"
        }
    }
}

{
    "data": {
        "additionalProperties": false,
        "properties": {
            "address": {
                "maxLength": 255,
                "title": "Address",
                "type": "string",
                "x-jsf-presentation": {
                    "inputType": "text"
                }
            },
            "address_line_2": {
                "description": "(Optional) For example, apartment, block, or building number.",
                "maxLength": 255,
                "title": "Address line 2",
                "type": [
                    "string",
                    "null"
                ],
                "x-jsf-presentation": {
                    "inputType": "text"
                }
            },
            "city": {
                "maxLength": 255,
                "title": "City",
                "type": "string",
                "x-jsf-presentation": {
                    "inputType": "text"
                }
            },
            "postal_code": {
                "description": "Make sure you enter the correct UK postal code format. Eg: KY11 9NN, N1 2NU, LS1 8EQ",
                "maxLength": 255,
                "pattern": "^([A-Z]{1,2}[0-9][A-Z0-9]?|[BFS]IQQ) ?[0-9][A-Z]{2}$",
                "title": "Postal code",
                "type": "string",
                "x-jsf-presentation": {
                    "inputType": "text"
                }
            }
        },
        "required": [
            "address",
            "city",
            "postal_code"
        ],
        "type": "object",
        "x-jsf-order": [
            "address",
            "address_line_2",
            "city",
            "postal_code"
        ]
    }
}

The status field in the company object can have the following values:

initiated: Indicates that a company has been created, but the owner has not completed self-enrollment.
pending: Indicates that a company has passed the initial step of onboarding after the owner verified their email address. Until the second step of sign-up workflow is completed, the company will stay in pending state.
review: Indicates that a company has finished sign-up but requires reviewal from Remote admin. A company can also be in review state if the owner did not accept terms of service. In this state, employers can create employees/contractors but they won't be able to invite them to start onboarding. Their state will stay as draft.
active: Indicates that a company is now active. Employers can now invite employees/contractors to start onboarding and sign the SLA.

ℹ️ For companies who had to sign the MSA, before the introduction of Terms of Service, will be marked active after the MSA has been signed.
archived: Indicates that a company has been archived by the Remote admin. Once a company is archived, all company related users will be set to deleted.