# Rate Card Sets (Group of Rate Cards)

A Rate Card Set represents a group of Rate Cards with multiple currencies that
can be bundled together. A Rate Card Set belongs to an account and can have several Rate Card Set Versions, each representing the
effective version for a specified date.

If the Rate Card feature is enabled, an account will always have an account default Rate Card Set. Rate
Cards belonging to the account default Rate Card Set are applied to projects by default when a Rate Card
is not explicitly set.

Additional custom Rate Card Sets can be created after the Rate Cards feature has been enabled on the
account. This can be done by making a request to the activations
endpoint.

## Fetching a list of Rate Card Sets

 - [GET /rate_card_sets](https://developer.kantata.com/kantata/specification/rate-card-sets-(group-of-rate-cards)/get-rate-card-sets.md): Rate Card Sets are only accessible to users with Financial access (Project Lead or higher) on the account.

An initial request to this endpoint, will generate an account default Rate Card Set and a create a
Rate Card Set Version. This account default Rate Card Set will include a separate Rate Card for every currency
used in projects on the user's account.


This endpoint returns structured Rate Card Set 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_sets top-level JSON key.
Please see our Response Format section for more information.

## Creating a new Rate Card Set

 - [POST /rate_card_sets](https://developer.kantata.com/kantata/specification/rate-card-sets-(group-of-rate-cards)/create-rate-card-set.md): This endpoint returns structured Rate Card Set 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_sets top-level JSON key.
Please see our Response Format section for more information.

## Fetching a single Rate Card Set

 - [GET /rate_card_sets/{id}](https://developer.kantata.com/kantata/specification/rate-card-sets-(group-of-rate-cards)/get-rate-card-set.md): A Rate Card Set can only be accessed by users with Financial access (Project Lead or higher) on the account.


This endpoint returns structured Rate Card Set 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_sets top-level JSON key.
Please see our Response Format section for more information.

## Updating an existing Rate Card Set

 - [PUT /rate_card_sets/{id}](https://developer.kantata.com/kantata/specification/rate-card-sets-(group-of-rate-cards)/update-rate-card-set.md): This endpoint returns structured Rate Card Set 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_sets top-level JSON key.
Please see our Response Format section for more information.

## Deleting an existing Rate Card Set

 - [DELETE /rate_card_sets/{id}](https://developer.kantata.com/kantata/specification/rate-card-sets-(group-of-rate-cards)/delete-rate-card-set.md): A Rate Card Set cannot be deleted if:
  - The Rate Card Set is the account default.
  - A Rate Card belonging to the Rate Card Set is being used by a project.


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.