# Price

How much a product costs and how often it bills. Pass its `id` as `priceId` to `createSubscription` or `updateSubscription`: the subscription copies `unitAmount`, `currency` and `recurring`, so a later change to the price never changes an existing subscription. Only `active`, `nickname` and `metadata` can change; to change the amount or the billing period, create a new price.

```
type Price {

  id: ID!

  productId: ID!

  currency: Currencies!

  unitAmount: Int!

  type: String!

  recurring: PriceRecurring

  active: Boolean!

  nickname: String

  metadata: [KeyValueItem!]

  createdAt: AWSTimestamp!

  updatedAt: AWSTimestamp

}
```

### Fields[​](#fields "Direct link to Fields")

#### [`Price.id`](#id) ● [`ID!`](https://docs.monei.com/apis/graphql/types/scalars/id.md) non-null scalar[​](#id "Direct link to id")

Price ID.

#### [`Price.productId`](#product-id) ● [`ID!`](https://docs.monei.com/apis/graphql/types/scalars/id.md) non-null scalar[​](#product-id "Direct link to product-id")

ID of the product of the price.

#### [`Price.currency`](#currency) ● [`Currencies!`](https://docs.monei.com/apis/graphql/types/enums/currencies.md) non-null enum[​](#currency "Direct link to currency")

Three-letter ISO 4217 currency code.

#### [`Price.unitAmount`](#unit-amount) ● [`Int!`](https://docs.monei.com/apis/graphql/types/scalars/int.md) non-null scalar[​](#unit-amount "Direct link to unit-amount")

Amount charged for each billing period, as a positive integer in the smallest currency unit.

#### [`Price.type`](#type) ● [`String!`](https://docs.monei.com/apis/graphql/types/scalars/string.md) non-null scalar[​](#type "Direct link to type")

How the price bills. Today always `RECURRING`; more values may be added.

#### [`Price.recurring`](#recurring) ● [`PriceRecurring`](https://docs.monei.com/apis/graphql/types/objects/price-recurring.md) object[​](#recurring "Direct link to recurring")

Billing period of a `RECURRING` price.

#### [`Price.active`](#active) ● [`Boolean!`](https://docs.monei.com/apis/graphql/types/scalars/boolean.md) non-null scalar[​](#active "Direct link to active")

Whether the price is active. An inactive price cannot start or switch a subscription. A price is archived with `active: false`; prices are never deleted.

#### [`Price.nickname`](#nickname) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string.md) scalar[​](#nickname "Direct link to nickname")

Internal label of the price, up to 100 characters.

#### [`Price.metadata`](#metadata) ● [`[KeyValueItem!]`](https://docs.monei.com/apis/graphql/types/objects/key-value-item.md) list object[​](#metadata "Direct link to metadata")

Key/value metadata that the merchant set.

#### [`Price.createdAt`](#created-at) ● [`AWSTimestamp!`](https://docs.monei.com/apis/graphql/types/scalars/awstimestamp.md) non-null scalar[​](#created-at "Direct link to created-at")

Creation time. Measured in seconds since the Unix epoch.

#### [`Price.updatedAt`](#updated-at) ● [`AWSTimestamp`](https://docs.monei.com/apis/graphql/types/scalars/awstimestamp.md) scalar[​](#updated-at "Direct link to updated-at")

Last update time. Measured in seconds since the Unix epoch.

### Returned By[​](#returned-by "Direct link to Returned By")

[`createPrice`](https://docs.monei.com/apis/graphql/operations/mutations/create-price.md) mutation ● [`price`](https://docs.monei.com/apis/graphql/operations/queries/price.md) query ● [`updatePrice`](https://docs.monei.com/apis/graphql/operations/mutations/update-price.md) mutation

### Member Of[​](#member-of "Direct link to Member Of")

[`PricesConnection`](https://docs.monei.com/apis/graphql/types/objects/prices-connection.md) object