Sign in

v1

latestOpenAPI 3.1.02026-07-242735131.1 MB
Cost Calculator

Creates a cost estimation of employments

post/v1/cost-calculator/estimation

Request body

company_namestring

The company name, used for labeling in PDF/CSV exports.

employer_currency_slugstring required

The ISO 4217 currency code for the employer's preferred currency (e.g., "USD"). All costs will be converted to this currency.

include_benefitsboolean

Whether to include benefit costs in the estimate. Defaults to false if not provided.

include_cost_breakdownsboolean

Whether to include detailed cost breakdowns (individual contributions, benefits, etc.) in the response.

include_management_feeboolean

Whether to include Remote's management fee in the total cost calculation.

include_premium_benefitsboolean

Whether to include premium benefit options in the estimate.

Example request

{
  "company_name": "My Company",
  "employer_currency_slug": "USD",
  "employments": [
    {
      "region_slug": "region_slug"
    }
  ]
}

Response

Success

Example response

{
  "data": {
    "employments": [
      {
        "country": {
          "alpha_2_code": "PT",
          "code": "PRT",
          "name": "Portugal",
          "slug": "portugal-ab18d96a-a9fd-42c0-9688-24f963d8bdc1"
        },
        "country_benefits_details_url": "https://example.com",
        "country_guide_url": "https://example1.com",
        "employer_currency_costs": {
          "annual_benefits_breakdown": [
            {
              "amount": 1120000,
              "description": "Description of how the amount is calculated.",
              "name": "Insurance",
              "zendesk_article_id": "1234",
              "zendesk_article_url": "https://examplezendesk.com/article/1234"
            }
          ],
          "annual_benefits_total": 1441200,
          "annual_contributions_breakdown": [
            {
              "amount": 1120000,
              "description": "Description of how the amount is calculated.",
              "name": "Insurance",
              "zendesk_article_id": "1234",
              "zendesk_article_url": "https://examplezendesk.com/article/1234"
            }
          ],
          "annual_contributions_total": 1441200,
          "annual_gross_salary": 12000000,
          "annual_indirect_tax": 120,
          "annual_management_fee": 0,
          "annual_total": 13441200,
          "currency": {
            "code": "EUR",
            "name": "European Euro",
            "slug": "eur-3b840951-099f-4bd5-90b9-032f7bfe51d9",
            "symbol": "€"
          },
          "discount": {
            "annual_amount": 120000,
            "monthly_amount": 10000,
            "months": 12,
            "text": "10% Discount"
          },
          "extra_statutory_payments_breakdown": [
            {
              "amount": 1120000,
              "description": "Description of how the amount is calculated.",
              "name": "Insurance",
              "zendesk_article_id": "1234",
              "zendesk_article_url": "https://examplezendesk.com/article/1234"
            }
          ],
          "extra_statutory_payments_total": 0,
          "monthly_benefits_breakdown": [
            {
              "amount": 1120000,
              "description": "Description of how the amount is calculated.",
              "name": "Insurance",
              "zendesk_article_id": "1234",
              "zendesk_article_url": "https://examplezendesk.com/article/1234"
            }
          ],
          "monthly_benefits_total": 120100,
          "monthly_contributions_breakdown": [
            {
              "amount": 1120000,
              "description": "Description of how the amount is calculated.",
              "name": "Insurance",
              "zendesk_article_id": "1234",
              "zendesk_article_url": "https://examplezendesk.com/article/1234"
            }
          ],
          "monthly_contributions_total": 120100,
          "monthly_gross_salary": 1000000,
          "monthly_indirect_tax": 10,
          "monthly_management_fee": 0,
          "monthly_tce": 1120000,
          "monthly_total": 1120100
        },
        "has_extra_statutory_payment": false,
        "minimum_onboarding_time": 10,
        "region": {
          "code": "USA",
          "name": "United States",
          "slug": "usd-663e0b79-c893-45ff-a1b2-f6dcabc098b5"
        },
        "regional_currency_costs": {
          "annual_benefits_breakdown": [
            {
              "amount": 1120000,
              "description": "Description of how the amount is calculated.",
              "name": "Insurance",
              "zendesk_article_id": "1234",
              "zendesk_article_url": "https://examplezendesk.com/article/1234"
            }
          ],
          "annual_benefits_total": 1441200,
          "annual_contributions_breakdown": [
            {
              "amount": 1120000,
              "description": "Description of how the amount is calculated.",
              "name": "Insurance",
              "zendesk_article_id": "1234",
              "zendesk_article_url": "https://examplezendesk.com/article/1234"
            }
          ],
          "annual_contributions_total": 1441200,
          "annual_gross_salary": 12000000,
          "annual_indirect_tax": 120,
          "annual_management_fee": 0,
          "annual_total": 13441200,
          "currency": {
            "code": "EUR",
            "name": "European Euro",
            "slug": "eur-3b840951-099f-4bd5-90b9-032f7bfe51d9",
            "symbol": "€"
          },
          "discount": {
            "annual_amount": 120000,
            "monthly_amount": 10000,
            "months": 12,
            "text": "10% Discount"
          },
          "extra_statutory_payments_breakdown": [
            {
              "amount": 1120000,
              "description": "Description of how the amount is calculated.",
              "name": "Insurance",
              "zendesk_article_id": "1234",
              "zendesk_article_url": "https://examplezendesk.com/article/1234"
            }
          ],
          "extra_statutory_payments_total": 0,
          "monthly_benefits_breakdown": [
            {
              "amount": 1120000,
              "description": "Description of how the amount is calculated.",
              "name": "Insurance",
              "zendesk_article_id": "1234",
              "zendesk_article_url": "https://examplezendesk.com/article/1234"
            }
          ],
          "monthly_benefits_total": 120100,
          "monthly_contributions_breakdown": [
            {
              "amount": 1120000,
              "description": "Description of how the amount is calculated.",
              "name": "Insurance",
              "zendesk_article_id": "1234",
              "zendesk_article_url": "https://examplezendesk.com/article/1234"
            }
          ],
          "monthly_contributions_total": 120100,
          "monthly_gross_salary": 1000000,
          "monthly_indirect_tax": 10,
          "monthly_management_fee": 0,
          "monthly_tce": 1120000,
          "monthly_total": 1120100
        }
      }
    ]
  }
}