---
title: "Creating a new Rate Card Set Version"
method: POST
path: "/rate_card_set_versions"
tags: ["Rate Card Set Version (Effective version by Date)"]
---

# Creating a new Rate Card Set Version

`POST /rate_card_set_versions`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/rate_card_set_versions`
- Auth: none declared

Rate Card Set Versions can only created by an Administrator on the account.

Creating/Cloning a Rate Card Set Version on a Rate Card Set, does the following:
  - Creates/Clones a Rate Card Version for each existing Rate Card on the associated Rate Card Set.
  - Creates/Clones necessary associations for each Rate Card Version.


This endpoint returns structured Rate Card Set Version objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `rate_card_set_versions` top-level JSON key.
Please see our [Response Format](#section/Response-Format) section for more information.

## Query parameters

- `clone_id` integer
- `include` string

## Request body

- object
  - `rate_card_set_version` object
    - `rate_card_set_id` integer, required: The ID of the Rate Card Set to which this version belongs.
    - `effective_date` string, date: The date from the which the current rate card set version takes effect. This will default to today. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.

## Response `200`

Rate Card Set Version has been created.

- object
  - `count` integer
  - `meta` object
    - `count` integer
    - `page_count` integer
    - `page_number` integer
    - `page_size` integer
  - `results` object[]
    - `key` string
    - `id` string
  - `rate_card_set_versions` object
  - `rate_card_sets` object
  - `rate_card_versions` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)