---
title: "Creates a CSV cost estimation of employments"
method: POST
path: "/v1/cost-calculator/estimation-csv"
tags: ["Cost Calculator"]
---

# Creates a CSV cost estimation of employments

`POST /v1/cost-calculator/estimation-csv`

Creates CSV cost estimation of employments

## Request body

- CostCalculatorEstimateParams — Parameters for generating a cost estimate for one or more employments across different countries/regions.
  - `company_name` string — The company name, used for labeling in PDF/CSV exports.
  - `employer_currency_slug` string, required — The ISO 4217 currency code for the employer's preferred currency (e.g., "USD"). All costs will be converted to this currency.
  - `employments` CostCalculatorEmploymentParam[], required — One or more employments to estimate costs for.
    - `age` integer — The employee's age. Used in some countries to calculate age-dependent benefits or contributions.
    - `annual_gross_salary` integer — The annual gross salary in the region's local currency, in cents. Provide this OR `annual_total_cost`, not both.
    - `annual_gross_salary_in_employer_currency` integer — The annual gross salary in the employer's preferred currency, in cents. Used when you want to specify salary in a different currency than the region's.
    - `annual_total_cost` integer — The target total annual cost (salary + all employer costs) in the region's local currency, in cents. The calculator will derive the gross salary. Provide this OR `annual_gross_salary`, not both.
    - `annual_total_cost_in_employer_currency` integer — The target total annual cost in the employer's preferred currency, in cents.
    - `benefits` CostCalculatorBenefitParam[] — Specific benefit selections to include in the estimate.
      - `benefit_group_slug` string, required — The unique identifier (slug) of the benefit group to include in the estimate.
      - `benefit_tier_slug` string, required — The unique identifier (slug) of the benefit tier within the group. Determines the level of coverage and cost.
    - `discount` CostCalculatorDiscount — Configuration for applying a discount to a cost estimate. Provide either an `amount` or `percent` — not both.
      - `amount` integer — The fixed discount amount in cents. Mutually exclusive with `percent`.
      - `months` integer — The number of months the discount applies to (1-12). Defaults to 12.
      - `percent` number — The discount as a decimal fraction (e.g., 0.1 for 10%). Mutually exclusive with `amount`.
      - `quoted_amount` integer — The originally quoted amount before discount, in cents.
      - `text` string, required — A human-readable label for the discount (e.g., "10% Discount").
    - `employment_term` 'fixed' | 'indefinite'
    - `region_slug` string, required — The unique identifier (slug) of the region/country for this employment. Required.
    - `regional_to_employer_exchange_rate` string — A custom exchange rate from the regional currency to the employer currency. If not provided, the current market rate is used.
    - `title` string — An optional label for this employment in the estimate (e.g., the job title or role name).
  - `global_discount` CostCalculatorDiscount — Configuration for applying a discount to a cost estimate. Provide either an `amount` or `percent` — not both.
    - `amount` integer — The fixed discount amount in cents. Mutually exclusive with `percent`.
    - `months` integer — The number of months the discount applies to (1-12). Defaults to 12.
    - `percent` number — The discount as a decimal fraction (e.g., 0.1 for 10%). Mutually exclusive with `amount`.
    - `quoted_amount` integer — The originally quoted amount before discount, in cents.
    - `text` string, required — A human-readable label for the discount (e.g., "10% Discount").
  - `include_benefits` boolean — Whether to include benefit costs in the estimate. Defaults to false if not provided.
  - `include_cost_breakdowns` boolean — Whether to include detailed cost breakdowns (individual contributions, benefits, etc.) in the response.
  - `include_management_fee` boolean — Whether to include Remote's management fee in the total cost calculation.
  - `include_premium_benefits` boolean — Whether to include premium benefit options in the estimate.

## Response `200`

Success

- CostCalculatorEstimateCSVResponse
  - `data` object, required
    - `content` string, binary, required — A file represented as a base64-encoded string.

## Other responses

- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/revisions/7e6a0c61ac82/schema)