Active Status

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": "[email protected]",
            "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": "[email protected]",
            "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"
        ]
    }
}