---
title: "Live teen inventory"
method: GET
path: "/inventory/teens"
tags: ["Inventory"]
---

# Live teen inventory

`GET /inventory/teens`

## Request

- Base URL: `https://www.primecutsnursery.com/api/v1`
- URL: `https://www.primecutsnursery.com/api/v1/inventory/teens`
- Auth: none required

Ready-to-flip teens available now and upcoming by ready date. Live data from the nursery's inventory system; cached ~2 minutes (`s-maxage=120`). Times are ISO 8601 UTC.

## Response `200`

Teen inventory

- object
  - `api_version` string, required
  - `publisher` Publisher, required
    - `name` string, required
    - `url` string, uri, required: Site root
    - `@id` string, uri, required: schema.org Organization @id used across the site's JSON-LD
  - `meta` Meta, required
    - `generated_at` string, date-time, required: When this payload was produced
    - `source` string, required: Where the data came from: 'repo' (curated site content) or 'live-inventory' (the nursery's live stock count, same figures as /live-inventory)
    - `as_of` string, date-time: For live data: when the underlying inventory snapshot was taken
    - `total` integer: Total matches before paging
    - `limit` integer
    - `offset` integer
    - `html_url` string, uri: Canonical HTML page for this resource
    - `notes` string[]: Caveats an agent should surface to a user
    - `interpreted` string[]: Search endpoints: how a free-text q was read (e.g. 'flowering ≤ 8 weeks')
  - `data` TeenInventory, required
    - `ok` boolean, required
    - `available` object[], required: Teens ready now
    - `upcoming` object[], required: Teens grouped by ready date
    - `totals` object, required
      - `available` integer, required
      - `upcoming` integer, required
    - `computed_at` string, date-time, required
    - `ordering` object
    - `html_url` string, uri, required: Canonical HTML page for this resource

## Other responses

- `503`: Inventory system unreachable

---

[API](https://skmtc.dev/primecutsnursery/apis/prime-cuts-nursery-public-api.md) · [All operations](https://skmtc.dev/primecutsnursery/apis/prime-cuts-nursery-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/primecutsnursery/apis/prime-cuts-nursery-public-api/revisions/ecf137a90e29?raw)