# rates (https://developer.godaddy.com/en/docs/references/rest/taxes/rate/queries/rates)

***

title: rates
description: "Get a collection of rates."
full: true
----------

query

Requires `commerce.tax:read`.

Get a collection of rates.

`orderBy` is one key only (`id`, `name`, `createdAt`, or `updatedAt`). Direction must be `ASC` or `DESC`. Sending two keys, or `"desc"`, fails validation. `value` is a union. Select `value { __typename ... on RatePercentage { percentage } ... on RateAmount { amount { value currencyCode } } }`. There is no `value { rate }` field.

## Required headers

| Header       | Required | Description                                                                                                                     |
| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `x-store-id` | Yes      | ID of the store the operation targets. Omitting it returns HTTP 200 with a GraphQL error: `extensions.code: "UNAUTHENTICATED"`. |

Go to [Authentication](https://developer.godaddy.com/docs/api-users/auth) for credential setup.

## Arguments

* `after` `String` **optional**
* `before` `String` **optional**
* `first` `Int` **optional**
* `id` `RateIdFilter` **optional**
  * `in` `[ID!]` **optional**
* `last` `Int` **optional**
* `orderBy` `RateOrderBy` **optional**
  * `createdAt` `OrderByDirectionEnum` **optional**
  * `id` `OrderByDirectionEnum` **optional**
  * `name` `OrderByDirectionEnum` **optional**
  * `updatedAt` `OrderByDirectionEnum` **optional**
* `referenceValue` `ReferenceValueFilter` **optional**
  * `in` `[String!]` **optional**
* `status` `RateStatusFilter` **optional**
  * `eq` `RateStatusEnum` **optional**
  * `in` `[RateStatusEnum!]` **optional**

## Possible returns

* `QueryRatesConnection` `QueryRatesConnection`

- `edges` `[QueryRatesConnectionEdge]` **nullable**
- `pageInfo` `PageInfo!` **non-null**