items Query

Description

Retrieves multiple items by their IDs or reference IDs.

query items($ids: [Long!], $itemRefs: [ID!]) {
  items(ids: $ids, itemRefs: $itemRefs) {
    _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

{
    "ids": [
        540323438529
    ],
    "itemRefs": [
        "2f3de77e247c171269f88a8f"
    ]
}

Response

{
    "items": [
        {
            "_id": "eb184fb3f472ed04a4e204c9",
            "id": 1.23,
            "type": "ReleaseItem",
            "incId": 1.23,
            "uniqueId": "example",
            "oldId": 1.23,
            "created": 1761682939180,
            "modified": 1763782418790,
            "seo": {
                "index": true,
                "description": "example",
                "slug": "example",
                "title": "example"
            },
            "isForbiddenForSale": true,
            "logs": [
                {
                    "action": "example",
                    "description": "example",
                    "date": 1741872712619,
                    "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": "46b32471df91c0ec5119b25c",
                    "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": 1711831670754,
                    "available": 1741888118020,
                    "preOrder": true,
                    "categories": [
                        "example"
                    ],
                    "archived": true,
                    "secondHand": true
                }
            ],
            "data": {
                "id": 1.23,
                "assetLink": "example",
                "thumb": "example",
                "title": "example",
                "discogsId": 987654321,
                "country": "example",
                "releaseDate": 1757602290693,
                "weight": 1.23,
                "genres": [
                    "example"
                ],
                "year": 42,
                "styles": [
                    "example"
                ],
                "manufacturer": "example",
                "cat": "example",
                "type": "example",
                "subtitle": "example",
                "authors": [
                    "example"
                ],
                "publisher": "example",
                "publishedDate": 1720305061784,
                "pageCount": 42,
                "categories": [
                    "example"
                ],
                "maturityRating": "example",
                "language": "example",
                "search": "example",
                "format": "example"
            }
        }
    ]
}

Arguments

Name	Type	Description
ids	[Long!]	List of numeric item IDs to retrieve.
itemRefs	[ID!]	List of item reference IDs (MongoDB ObjectIds) to retrieve.

Returns

[Item!]