items Query

Description

Retrieves multiple items by their IDs or reference IDs.

query items($ids: [String!], $itemRefs: [ID!]) {
  items(ids: $ids, itemRefs: $itemRefs) {
    creatorsId
    _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
      lastCopyAutomation
    }
    data {
      hsCode
      id
      assetLink
      thumb
      snippetRef
      title
      discogsId
      country
      releaseDate
      weight
      genres
      year
      styles
      manufacturer
      cat
      type
      subtitle
      authors
      publisher
      publishedDate
      pageCount
      categories
      maturityRating
      language
      search
      format
    }
  }
}

Variables

{
    "ids": [
        "08a16b83-9094-4e89-8c05-2ccadd5c1c7e"
    ],
    "itemRefs": [
        "c68af0ae3ab7dc53659cad33"
    ]
}

Response

{
    "items": [
        {
            "creatorsId": "example",
            "_id": "81d35c4e90973ba89b2e0369",
            "id": "example",
            "type": "ReleaseItem",
            "incId": 1.23,
            "uniqueId": "example",
            "oldId": 1.23,
            "created": 1787485503243,
            "modified": 1790331398844,
            "seo": {
                "index": true,
                "description": "example",
                "slug": "example",
                "title": "example"
            },
            "isForbiddenForSale": true,
            "logs": [
                {
                    "action": "example",
                    "description": "example",
                    "date": 1730882283242,
                    "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": "1568890475bfb2e5a25928ee",
                    "id": "example",
                    "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": 1756614301236,
                    "available": 1729941480192,
                    "preOrder": true,
                    "categories": [
                        "example"
                    ],
                    "archived": true,
                    "secondHand": true,
                    "lastCopyAutomation": true
                }
            ],
            "data": {
                "hsCode": "example",
                "id": 1.23,
                "assetLink": "example",
                "thumb": "example",
                "snippetRef": "b17d870c61d3862d5e54cd6c",
                "title": "example",
                "discogsId": 987654321,
                "country": "example",
                "releaseDate": 1752165861916,
                "weight": 1.23,
                "genres": [
                    "example"
                ],
                "year": 42,
                "styles": [
                    "example"
                ],
                "manufacturer": "example",
                "cat": "example",
                "type": "example",
                "subtitle": "example",
                "authors": [
                    "example"
                ],
                "publisher": "example",
                "publishedDate": 1733776818773,
                "pageCount": 42,
                "categories": [
                    "example"
                ],
                "maturityRating": "example",
                "language": "example",
                "search": "example",
                "format": "example"
            }
        }
    ]
}

Arguments

Name	Type	Description
ids	[String!]	List of item IDs to retrieve. Strings since the id migration — article item blocks store these, and a nanoid cannot be a Long.
itemRefs	[ID!]	List of item reference IDs (MongoDB ObjectIds) to retrieve.

Returns

[Item!]