---
title: Store Stock
slug: redcircleapi/target-product-data-api/results/store-stock
docTags:
createdAt: 2024-07-27T14:22:43.825Z
---
# Store Stock Results
When making a request with the `type` [parameter](https://docs.trajectdata.com/redcircleapi/target-product-data-api/parameters/product) set to `type=store_stock` RedCircle API will retrieve in-store stock information of a single product on Target - the product is specified using either the `tcin` , `dpci` or `url` parameter (where the `url` parameter contains a link to an Target product page).
The location to perform the search is specified using the `store_stock_zipcode` parameter. Up to 20 stores within a 50 mile radius of the specified zipcode will be returned in the `store_stock_results` array.
Store stock details are retrieved from the [store stock check page](https://www.target.com/p/sharpie-4pk-highlighters-pocket-style-chisel-tip-multicolor/-/A-78025470) for a single product on Target.
An example of the JSON object returned from an Store Stock request is shown below:
```json
{
"request_info": {
"success": true,
"credits_used": 1,
"credits_remaining": 999
},
"request_metadata": {
"created_at": "2020-01-01T00:00:00.000Z",
"processed_at": "2020-01-01T00:00:00.001Z",
"total_time_taken": 0.1,
"target_url": "https://www.target.com/p/-/A-78025470"
},
"request_parameters": {
"type": "store_stock",
"store_stock_zipcode": "52404",
"tcin": "78025470"
},
"store_stock_results": [
{
"position": 1,
"store_name": "Cedar Rapids South",
"store_id": "1771",
"in_stock": true,
"stock_level": 13,
"address": "3400 Edgewood Rd SW",
"city": "Cedar Rapids",
"state": "Iowa",
"zipcode": "52404-7214",
"phone": "319-396-4444",
"distance": 1.58
},
{
"position": 2,
"store_name": "Cedar Rapids North",
"store_id": "1768",
"in_stock": true,
"stock_level": 2,
"address": "1030 Blairs Ferry Rd NE",
"city": "Cedar Rapids",
"state": "Iowa",
"zipcode": "52402-1220",
"phone": "319-393-1600",
"distance": 6.54
},
{
"position": 3,
"store_name": "Coralville",
"store_id": "1113",
"in_stock": true,
"stock_level": 5,
"address": "1441 Coral Ridge Ave",
"city": "Coralville",
"state": "Iowa",
"zipcode": "52241-2801",
"phone": "319-351-5150",
"distance": 18.13
},
{
"position": 4,
"store_name": "Iowa City Downtown",
"store_id": "3374",
"in_stock": true,
"stock_level": 8,
"address": "113 E. Washington St",
"city": "Iowa City",
"state": "Iowa",
"zipcode": "52240-3925",
"phone": "319-471-4912",
"distance": 21.25
},
{
"position": 5,
"store_name": "Waterloo",
"store_id": "1792",
"in_stock": true,
"stock_level": 6,
"address": "1501 E San Marnan Dr",
"city": "Waterloo",
"state": "Iowa",
"zipcode": "50702-4300",
"phone": "319-226-6500",
"distance": 48.63
}
],
"product": {
"tcin": "78025470",
"dpci": "081-02-3451"
}
}
```
RedCircle API returns the following properties for Store Stock requests:
| `Property` | `Type` | `Description` |
| --------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `store_stock_results` | `array` | An array containing up to 20 Store Stock objects showing in-store stock status for the requested `tcin` in stores within a 50-mile radius of the requested `store_stock_zipcode` .
* `position`
* `string`
* The position of the result in the `store_stock_results` array.
* `in_stock`
* boolean
* Set to `true` if this store has stock of the given `tcin` , otherwise `false` .
* `stock_level`
* `number`
* The quantity of stock available in the given store, if shown.
* `address`
* `string`
* The address of the store the request was run in.
* `city`
* `string`
* The city the request was run in.
* `state`
* `string`
* The state the request was run in.
* `zipcode`
* `string`
* The zipcode the request was run in.
* `phone`
* `string`
* The phone number of the store, if shown.
* `store_name`
* `string`
* The name of the store that the request was run from.
* `store_id`
* `string`
* The ID of the store that the request was run from.
* `distance`
* number
* The distance, in fractional miles, of the store from the zipcode specified in the `store_stock_zipcode` request parameter. |
| `product` | `object` | An object containing details of the product for which in-store stock data was requested.
* `tcin`
* `string`
* The product TCIN (Target product ID).
* `dpci`
* `string`
* The Target "Department - Class - Item" ID of the product. |
***
**Next Steps**
[Store Stock Parameters](https://docs.trajectdata.com/redcircleapi/target-product-data-api/parameters/store-stock)