> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.getmeadow.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a package > Retrieve package information for a specific label/tag ## OpenAPI ````yaml GET /api/v1/packages/{label} openapi: 3.0.1 info: title: Meadow Open API description: The API to connect to the Meadow platform version: 1.0.0 servers: - url: https://api-staging.getmeadow.com - url: https://api.getmeadow.com security: - meadowConsumer: [] meadowClient: [] paths: /api/v1/packages/{label}: get: description: Retrieve package information for a specific label/tag parameters: - name: label in: path description: The label of the package to retrieve required: true schema: type: string responses: '200': description: Packages detail response content: application/json: schema: $ref: '#/components/schemas/Package' example: data: id: 150 organizationId: 1 type: metrc externalId: null externalProductName: OG Kush - Eighth label: STAGING01234567200000001 status: received initialAmount: '150' unit: Each createdAt: '2023-01-10T21:35:10.732Z' updatedAt: '2023-05-05 10:17:56.561-07' receivedAt: '2023-05-05T17:17:56.561Z' finishedAt: null multiplier: '1' expirationDate: '2024-03-07' transferredAt: null transferReturnedAt: null shippedAt: null costPerUnit: '24.9567' voidReason: null thcPercent: '24.5' thcMg: null cbdPercent: '2.7' cbdMg: null producerName: null producerLicense: null harvestDate: null harvestFacilityName: null harvestFacilityLicense: null labName: null labLicense: null labDate: null onHold: false tradeSample: false originalSourceLabel: null productOptionId: 1250 locationInventory: - inventoryLocationId: 3 amount: '90' - inventoryLocationId: 41 amount: '9' product: id: 798 name: OG Kush unit: item strainType: hybrid-indica isActive: true isFeatured: false inventoryType: option movingAverageCostPerUnit: null brandName: Meadow Farms primaryCategory: id: 8 name: Flower cannabisType: non-concentrated options: - id: 1250 name: '' amount: 1 price: 2400 salesPrice: null content: 3.5 movingAverageCostPerUnit: 0 4XX: description: Unexpected error content: application/json: schema: $ref: '#/components/schemas/APIError' components: schemas: Package: type: object properties: id: type: number description: The id for the package productOptionId: type: number description: >- If this package is for an `option` tracking product, this value will be set. You can lookup which product option has inventory for this package in `product.options[].id` of this response. nullable: true type: type: string description: >- The compliance system for this package. Only `metrc` is supported currently. enum: - metrc externalId: type: string description: The ID of the package in the external compliance system (Metrc) nullable: true externalProductName: type: string description: >- The name of the product for this package in the external compliance system (Metrc) nullable: true label: type: string description: The tag/label identifier for the package status: type: string description: >- The status of the package - `ready` is a package that has not been received into inventory yet. - `received` is a package that has been accepted into inventory for sale - `finished` is a package with 0 inventory and has been marked as finished - `shipped` is a package that is currently being shipped to another license and not available for sale - `transferred` is a package that was transferred out of this license and no longer has inventory - `transfer-returned` is a package that has been transferred back, but has not been received into inventory yet - `syncing` is a package that has been created, but not synced to Metrc yet enum: - ready - received - finished - shipped - transferred - transfer-returned - syncing initialAmount: type: string description: >- The amount of inventory this package had in Metrc when it was first imported into Meadow. This does not reflect how much inventory is currently available in Meadow. unit: type: string description: 'The Metrc unit of the package. (Example: `Each` or `Grams`)' createdAt: type: string description: When this package was first created in Meadow updatedAt: type: string description: >- The last time this package had a modification made to it or an inventory transaction associated with it receivedAt: type: string description: When this package was received into inventory nullable: true finishedAt: type: string description: When this package was set as finished nullable: true multiplier: type: string description: >- This number represents the relationship between 1 unit of inventory in Meadow and how many units that represents in the Metrc package. For example, if a Metrc package has a unit of `Grams`, then the multiplier may be something like `3.5` to represent that one pre-packed eighth in Meadow will use 3.5g of the Metrc package. This is only applicable for `option` tracking products. `product` tracking will always have a value of `1`. Please refer to the [Inventory Guide](/guides/inventory) for information on `option` and `product` tracking. nullable: true expirationDate: type: string description: The expiration date of the package nullable: true transferredAt: type: string description: When this package was transferred out of this organization nullable: true transferReturnedAt: type: string description: When this package was transferred back to this organization nullable: true shippedAt: type: string description: When this package was shipped out of this organization nullable: true costPerUnit: type: string description: The cost per unit for this package nullable: true voidReason: type: string description: If this package has been voided, it will always have a reason nullable: true thcPercent: type: string description: The THC percent of this package nullable: true thcMg: type: string description: The THC contents in mg of this package nullable: true cbdPercent: type: string description: The CBD percent of this package nullable: true cbdMg: type: string description: The CBD contents in mg of this package nullable: true producerName: type: string description: The name of the producer of this package nullable: true producerLicense: type: string description: 'The state license # of the producer' nullable: true harvestDate: type: string description: The harvest date of this package nullable: true harvestFacilityName: type: string description: The name of the facility that harvested this package nullable: true harvestFacilityLicense: type: string description: 'The state license # of the harvest facility' nullable: true labName: type: string description: The name of the lab testing facility nullable: true labLicense: type: string description: 'The state license # of the lab testing facility' nullable: true labDate: type: string description: The date of the lab testing results for this package nullable: true onHold: type: boolean description: Whether this package is on "administrative hold" in Metrc tradeSample: type: boolean description: Whether this package is designated as a trade sample originalSourceLabel: type: string description: >- The original source label for this package's root parent. Provided by Metrc for use in Retail ID context nullable: true locationInventory: type: array description: >- The Meadow inventory for this package broken out by inventory location. An empty array `[]` means that this package does not have any inventory. items: type: object properties: inventoryLocationId: type: number description: The id for this inventory location amount: type: string description: The amount of inventory available for sale product: type: object description: >- Information about the product this package has inventory for. This will be `null` if the package has not had its inventory received to a Meadow product yet. nullable: true properties: id: type: number description: The ID of the product name: type: string description: The name of the product unit: type: string description: Either `gram` or `item` strainType: type: string description: The strain type of the product enum: - sativa - indica - hybrid - hybrid-sativa - hybrid-indica - cbd - mixed - none isActive: type: boolean description: Whether the product is active on menus or not isFeatured: type: boolean description: Whether the product is featured or not inventoryType: type: string description: >- Either `option` or `product`. Please refer to the [Inventory Guide](/guides/inventory) for more information. movingAverageCostPerUnit: type: boolean description: >- The moving average cost per unit for this product if this products inventoryType is `product` nullable: true brandName: type: string description: The brand name of this product nullable: true primaryCategory: type: object description: The category for this product properties: id: type: number description: ID of the category name: type: string description: The name of the category cannabisType: type: string description: >- One of the following values: `non-concentrated` - Flower or other non-concentrated THC products `concentrated` - Concentrated THC products (Example: Edibles, Concentrates) `immature-plant` - Cannabis plants `none` - This product does not contain cannabis `mi-infused-solids` - Cannabis infused solids (only in Michigan) (Example: edibles) `mi-infused-fluids` - Cannabis infused fluids (only in Michigan) (Example: drinks) `edibles` - Edible product (only used in New Jersey & Massachusetts) options: type: array description: All of the pricing options for this product items: properties: id: type: number description: The ID of this option name: type: string description: The name of this option nullable: true amount: type: number description: The amount of the underlying unit of this product price: type: number description: The price in cents of this option salesPrice: type: number description: The sales price in cents if one exists nullable: true content: type: string description: The cannabis content of this option movingAverageCostPerUnit: type: string description: The moving average cost per unit for this product option nullable: true APIError: required: - error - message type: object properties: error: type: object properties: message: type: string example: A description of the error code code: type: string example: CODE_OF_ERROR_WILL_BE_HERE securitySchemes: meadowConsumer: type: apiKey name: X-Consumer-Key description: The key assigned to your company and provided via Meadow in: header meadowClient: type: apiKey name: X-Client-Key description: The key generated and provided by our mutual client in: header ````