# sku

From **Stripe API**.

Stores representations of [stock keeping units](http://en.wikipedia.org/wiki/Stock_keeping_unit).
SKUs describe specific product variations, taking into account any combination of: attributes,
currency, and cost. For example, a product may be a T-shirt, whereas a specific SKU represents
the `size: large`, `color: red` version of that shirt.

Can also be used to manage inventory.

Related guide: [Tax, Shipping, and Inventory](https://stripe.com/docs/orders).

- Type: `object`

## Properties

### `active`

- Required: true
- Type: `boolean`

Whether the SKU is available for purchase.

### `attributes`

- Required: true
- Type: `object`

A dictionary of attributes and values for the attributes defined by the product. If, for example, a product's attributes are `["size", "gender"]`, a valid SKU has the following dictionary of attributes: `{"size": "Medium", "gender": "Unisex"}`.

### `created`

- Required: true
- Type: `integer`
- Format: `unix-time`

Time at which the object was created. Measured in seconds since the Unix epoch.

### `currency`

- Required: true
- Type: `string`

Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).

### `id`

- Required: true
- Type: `string`
- maxLength: `5000`

Unique identifier for the object.

### `image`

- Required: false
- Type: `string`
- Nullable: true
- maxLength: `2048`

The URL of an image for this SKU, meant to be displayable to the customer.

### `inventory`

- Required: true
- Type: `object`

### `livemode`

- Required: true
- Type: `boolean`

Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

### `metadata`

- Required: true
- Type: `object`

Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

### `object`

- Required: true
- Type: `string`
- Allowed values: `"sku"`

String representing the object's type. Objects of the same type share the same value.

### `package_dimensions`

- Required: false
- Nullable: true

The dimensions of this SKU for shipping purposes.

### `price`

- Required: true
- Type: `integer`

The cost of the item as a positive integer in the smallest currency unit (that is, 100 cents to charge $1.00, or 100 to charge ¥100, Japanese Yen being a zero-decimal currency).

### `product`

- Required: true
The ID of the product this SKU is associated with. The product must be currently active.

### `updated`

- Required: true
- Type: `integer`
- Format: `unix-time`

Time at which the object was last updated. Measured in seconds since the Unix epoch.

## JSON Schema

```json
{"description":"Stores representations of [stock keeping units](http://en.wikipedia.org/wiki/Stock_keeping_unit).\nSKUs describe specific product variations, taking into account any combination of: attributes,\ncurrency, and cost. For example, a product may be a T-shirt, whereas a specific SKU represents\nthe `size: large`, `color: red` version of that shirt.\n\nCan also be used to manage inventory.\n\nRelated guide: [Tax, Shipping, and Inventory](https://stripe.com/docs/orders).","properties":{"active":{"description":"Whether the SKU is available for purchase.","type":"boolean"},"attributes":{"additionalProperties":{"maxLength":5000,"type":"string"},"description":"A dictionary of attributes and values for the attributes defined by the product. If, for example, a product's attributes are `[\"size\", \"gender\"]`, a valid SKU has the following dictionary of attributes: `{\"size\": \"Medium\", \"gender\": \"Unisex\"}`.","type":"object"},"created":{"description":"Time at which the object was created. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"currency":{"description":"Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).","type":"string"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"image":{"description":"The URL of an image for this SKU, meant to be displayable to the customer.","maxLength":2048,"nullable":true,"type":"string"},"inventory":{"$ref":"#/components/schemas/sku_inventory"},"livemode":{"description":"Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.","type":"boolean"},"metadata":{"additionalProperties":{"maxLength":500,"type":"string"},"description":"Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.","type":"object"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["sku"],"type":"string"},"package_dimensions":{"anyOf":[{"$ref":"#/components/schemas/package_dimensions"}],"description":"The dimensions of this SKU for shipping purposes.","nullable":true},"price":{"description":"The cost of the item as a positive integer in the smallest currency unit (that is, 100 cents to charge $1.00, or 100 to charge ¥100, Japanese Yen being a zero-decimal currency).","type":"integer"},"product":{"anyOf":[{"maxLength":5000,"type":"string"},{"$ref":"#/components/schemas/product"}],"description":"The ID of the product this SKU is associated with. The product must be currently active.","x-expansionResources":{"oneOf":[{"$ref":"#/components/schemas/product"}]}},"updated":{"description":"Time at which the object was last updated. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"}},"required":["active","attributes","created","currency","id","inventory","livemode","metadata","object","price","product","updated"],"title":"Sku","type":"object","x-expandableFields":["inventory","package_dimensions","product"],"x-resourceId":"sku"}
```