# Rate Card Role (Rate for a Role)

Rate Card Roles belong to a Rate Card Version and represent the bill rate, in cents per hour, for a specific Role.
For example, the rate for the role of Developer may be 2000 cents per hour. It is not necessary, however, to create a Rate Card Role for
every role on your account if the rate is the same as the default rate on the Rate Card Version. When an
explicit Rate Card Role does not exist for a role on the account, the default rate on the Rate Card Version
is used to calculate the total bill rate.

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

## Fetching a list of Rate Card Roles

 - [GET /rate_card_roles](https://developer.kantata.com/kantata/specification/rate-card-role-(rate-for-a-role)/get-rate-card-roles.md): Returns the Rate Card Roles associated with all Rate Card Versions on Rate Cards that belong to the logged-in user's account.

Rate Card Roles can only be accessed by an Administrator on the account.


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

## Creating a new Rate Card Role

 - [POST /rate_card_roles](https://developer.kantata.com/kantata/specification/rate-card-role-(rate-for-a-role)/create-rate-card-role.md): A Rate Card Role can only be created by an Administrator on the account.


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

## Fetching a single Rate Card Role

 - [GET /rate_card_roles/{id}](https://developer.kantata.com/kantata/specification/rate-card-role-(rate-for-a-role)/get-rate-card-role.md): A Rate Card Role can only be accessed by an Administrator on the account.


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

## Updating an existing Rate Card Role

 - [PUT /rate_card_roles/{id}](https://developer.kantata.com/kantata/specification/rate-card-role-(rate-for-a-role)/update-rate-card-role.md): A Rate Card Role can only be modified by an Administrator on the account.


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

## Deleting an existing Rate Card Role

 - [DELETE /rate_card_roles/{id}](https://developer.kantata.com/kantata/specification/rate-card-role-(rate-for-a-role)/delete-rate-card-role.md): If a A Rate Card Role belongs to a Rate Card Version that is in use, it cannot be deleted. A Rate Card Role can
only be deleted by an Administrator on the account.


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.