item Query

Description

Retrieves a single item by ID, listing reference, or item reference. Can search by numeric item ID, listing reference ID, or item reference ID.

query item($id: Long, $listingRef: ID, $itemRef: ID) {
  item(id: $id, listingRef: $listingRef, itemRef: $itemRef) {
    _id
    id
    type
    incId
    uniqueId
    oldId
    created
    modified
    seo {
      index
      description
      slug
      title
    }
    isForbiddenForSale
    logs {
      action
      description
      date
      ip
    }
    handle
    path
    uri
    wants
    bitly
    descriptions {
      main
    }
    listings {
      _id
      id
      status
      comments
      privateComments
      location
      discogsId
      taxDefinition
      preventDiscogsListing
      readOnly
      onePerCustomer
      supplierCode
      sku
      barcode
      posted
      available
      preOrder
      categories
      archived
      secondHand
    }
    data {
      id
      assetLink
      thumb
      title
      discogsId
      country
      releaseDate
      weight
      genres
      year
      styles
      manufacturer
      cat
      type
      subtitle
      authors
      publisher
      publishedDate
      pageCount
      categories
      maturityRating
      language
      search
      format
    }
  }
}

Variables

{
    "id": 2892947582313,
    "listingRef": "371fbc1b89dc1e60531846ad",
    "itemRef": "500f2ee6d4d3f78319a88442"
}

Response

{
    "item": {
        "_id": "6d0560b946808941c0406933",
        "id": 1.23,
        "type": "ReleaseItem",
        "incId": 1.23,
        "uniqueId": "example",
        "oldId": 1.23,
        "created": 1716334283091,
        "modified": 1707711525376,
        "seo": {
            "index": true,
            "description": "example",
            "slug": "example",
            "title": "example"
        },
        "isForbiddenForSale": true,
        "logs": [
            {
                "action": "example",
                "description": "example",
                "date": 1736688028017,
                "ip": "example"
            }
        ],
        "handle": "example",
        "path": "/release/1763553751/release-artist-release-name",
        "uri": "https://www.my-common-ground-store.com/release/1763553751/release-artist-release-name",
        "wants": 42,
        "bitly": "example",
        "descriptions": {
            "main": "example"
        },
        "listings": [
            {
                "_id": "02102b33487131bc35c37a7b",
                "id": 1.23,
                "status": "example",
                "comments": "example",
                "privateComments": "example",
                "location": "example",
                "discogsId": 987654321,
                "taxDefinition": "example",
                "preventDiscogsListing": true,
                "readOnly": true,
                "onePerCustomer": true,
                "supplierCode": "example",
                "sku": "example",
                "barcode": "example",
                "posted": 1716659701048,
                "available": 1717262283120,
                "preOrder": true,
                "categories": [
                    "example"
                ],
                "archived": true,
                "secondHand": true
            }
        ],
        "data": {
            "id": 1.23,
            "assetLink": "example",
            "thumb": "example",
            "title": "example",
            "discogsId": 987654321,
            "country": "example",
            "releaseDate": 1708383725973,
            "weight": 1.23,
            "genres": [
                "example"
            ],
            "year": 42,
            "styles": [
                "example"
            ],
            "manufacturer": "example",
            "cat": "example",
            "type": "example",
            "subtitle": "example",
            "authors": [
                "example"
            ],
            "publisher": "example",
            "publishedDate": 1755134246065,
            "pageCount": 42,
            "categories": [
                "example"
            ],
            "maturityRating": "example",
            "language": "example",
            "search": "example",
            "format": "example"
        }
    }
}

Arguments

Name	Type	Description
id	Long	Numeric item ID to search for.
listingRef	ID	Listing reference ID to find the item that contains this listing.
itemRef	ID	Item reference ID (MongoDB ObjectId) to retrieve the item directly.

Returns

Item