# Rate Card Set Version (Effective version by Date)

In the Rate Card system, Rate Card Set Versions represent snapshots of a Rate Card Set,
that take effect on the set published date. A Rate Card Set Version owns a copy of each Rate Card Version
of a Rate Card in the associated Rate Card Set.

Rate Card Roles can only be accessed, edited, or published by an Administrator on the account.

Since Rate Cards and Rate Card Versions are immutable after they are published and in use, generating a
Rate Card Set Version is the correct process for making any changes. When a new Rate Card Set Version
is created or cloned, all of the Rate Card Versions from the old Rate Card Set Version are copied
to a new one.

## Fetching a list of Rate Card Set Versions

 - [GET /rate_card_set_versions](https://developer.kantata.com/kantata/specification/rate-card-set-version-(effective-version-by-date)/get-rate-card-set-versions.md): Rate Card Set Versions are only accessible to Administrators on the account.


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 for more information.

## Creating a new Rate Card Set Version

 - [POST /rate_card_set_versions](https://developer.kantata.com/kantata/specification/rate-card-set-version-(effective-version-by-date)/create-rate-card-set-version.md): 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 for more information.

## Fetching a single Rate Card Set Version

 - [GET /rate_card_set_versions/{id}](https://developer.kantata.com/kantata/specification/rate-card-set-version-(effective-version-by-date)/get-rate-card-set-version.md): A Rate Card Set Version is only accessible to an Administrator on the account.


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 for more information.

## Updating an existing Rate Card Set Version

 - [PUT /rate_card_set_versions/{id}](https://developer.kantata.com/kantata/specification/rate-card-set-version-(effective-version-by-date)/update-rate-card-set-version.md): A Rate Card Set Version can only be modified when the effective date is in the future, or when it is not yet
published.


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 for more information.

## Deleting an existing Rate Card Set Version

 - [DELETE /rate_card_set_versions/{id}](https://developer.kantata.com/kantata/specification/rate-card-set-version-(effective-version-by-date)/delete-rate-card-set-version.md): The response will contain no content and an HTTP 204 status code if the request was
successful, or a standard Kantata OX error message explaining why the object could not be deleted.

## Publish a Rate Card Set Version

 - [PUT /rate_card_set_versions/{id}/publish](https://developer.kantata.com/kantata/specification/rate-card-set-version-(effective-version-by-date)/publish-rate-card-set-version.md): Publishing a Rate Card Set Version means activating the version from the set effective date.
A Rate Card Set Version can be published to any future date, but cannot be published on the same
effective date as another Rate Card Set Version on the same Rate Card Set. Once published, a Rate Card
Set Version cannot be unpublished.


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 for more information.