Skip to main content
GET
/
public
/
catalog
/
{ItemId}
curl -i -X GET \
  'https://api.portal.io/public/catalog/8821?ExtendedDetails=true' \
  -H 'Accept: application/json' \
  -H 'X-MSS-API-APPID: YOUR_APP_ID' \
  -H 'X-MSS-API-USERKEY: YOUR_USER_KEY' \
  -H 'X-MSS-CUSTOM-DATE: Mon, 06 Apr 2026 00:22:19 GMT' \
  -H 'X-MSS-SIGNATURE: BASE64_SIGNATURE'
{
  "description": "The AVR-X3800H is a 9.4-channel, 105W AV receiver with 8K video support...",
  "productUrl": "https://portal.io/catalog/8821",
  "manufacturerProductUrl": "https://www.denon.com/avr-x3800h",
  "additionalImageUrls": [
    "https://images.portal.io/catalog/8821/angle.jpg"
  ],
  "pdfResourceLinks": [
    { "name": "Owner's Manual", "url": "https://docs.denon.com/avr-x3800h-manual.pdf" }
  ],
  "videoResourceLinks": [],
  "specs": [
    { "name": "Channels", "value": "9.4" },
    { "name": "Power Output", "value": "105W per channel" }
  ],
  "suppliers": [
    {
      "id": 5,
      "name": "D&H Distributing",
      "cost": {
        "value": 975.00,
        "isPromo": false,
        "isInStock": true,
        "unitOfMeasure": "Each",
        "discountPercentage": 0,
        "currency": { "code": "USD", "symbol": "$" },
        "lastVerifiedDate": "2026-04-01T00:00:00Z"
      }
    }
  ],
  "id": 8821,
  "brand": "Denon",
  "model": "AVR-X3800H",
  "shortDescription": "9.4-Channel 105W 8K AV Receiver",
  "primaryImageUrl": "https://images.portal.io/catalog/8821/primary.jpg",
  "parentCategoryId": 12,
  "categoryId": 47,
  "categories": ["Audio", "AV Receivers"],
  "isFavorite": false,
  "isDiscontinued": false,
  "rank": 1,
  "msrp": {
    "msrpUsd": 1299.00,
    "value": 1299.00,
    "regularValue": 1299.00,
    "isCustom": false,
    "currency": { "code": "USD", "symbol": "$" },
    "lastModifiedDate": "2026-01-15T00:00:00Z"
  },
  "defaultCost": {
    "supplierName": "D&H Distributing",
    "supplierSku": "AVR-X3800H",
    "managePriceStatus": "Activated",
    "accountNumber": "DH-12345",
    "isInStock": true,
    "isPromo": false,
    "lastVerifiedDate": "2026-04-01T00:00:00Z",
    "unitOfMeasure": "Each",
    "discountPercentage": 0,
    "regularValue": 975.00,
    "isCustom": false,
    "value": 975.00,
    "lastModifiedDate": "2026-04-01T00:00:00Z",
    "currency": { "code": "USD", "symbol": "$" }
  },
  "sellPrice": {
    "type": "CostMultiplier",
    "costMultiplier": 1.4,
    "value": 1365.00,
    "lastModifiedDate": "2026-03-01T00:00:00Z",
    "currency": { "code": "USD", "symbol": "$" }
  }
}
Returns the complete record for a single catalog item. By default this includes pricing, category data, and supplier information. Pass ExtendedDetails=true to also receive the full long description, technical specifications, linked PDF and video resources, and additional image URLs. When ItemType is Labor or CustomItem, the item is sourced from your account’s private library rather than the shared catalog.
The Catalog endpoints require separate authorization. Contact your Portal.io representative to confirm your account has catalog API access enabled.
A 204 response (not 404) is returned when the ItemId does not match any catalog item. Check for this status code in your error handling logic.
curl -i -X GET \
  'https://api.portal.io/public/catalog/8821?ExtendedDetails=true' \
  -H 'Accept: application/json' \
  -H 'X-MSS-API-APPID: YOUR_APP_ID' \
  -H 'X-MSS-API-USERKEY: YOUR_USER_KEY' \
  -H 'X-MSS-CUSTOM-DATE: Mon, 06 Apr 2026 00:22:19 GMT' \
  -H 'X-MSS-SIGNATURE: BASE64_SIGNATURE'
{
  "description": "The AVR-X3800H is a 9.4-channel, 105W AV receiver with 8K video support...",
  "productUrl": "https://portal.io/catalog/8821",
  "manufacturerProductUrl": "https://www.denon.com/avr-x3800h",
  "additionalImageUrls": [
    "https://images.portal.io/catalog/8821/angle.jpg"
  ],
  "pdfResourceLinks": [
    { "name": "Owner's Manual", "url": "https://docs.denon.com/avr-x3800h-manual.pdf" }
  ],
  "videoResourceLinks": [],
  "specs": [
    { "name": "Channels", "value": "9.4" },
    { "name": "Power Output", "value": "105W per channel" }
  ],
  "suppliers": [
    {
      "id": 5,
      "name": "D&H Distributing",
      "cost": {
        "value": 975.00,
        "isPromo": false,
        "isInStock": true,
        "unitOfMeasure": "Each",
        "discountPercentage": 0,
        "currency": { "code": "USD", "symbol": "$" },
        "lastVerifiedDate": "2026-04-01T00:00:00Z"
      }
    }
  ],
  "id": 8821,
  "brand": "Denon",
  "model": "AVR-X3800H",
  "shortDescription": "9.4-Channel 105W 8K AV Receiver",
  "primaryImageUrl": "https://images.portal.io/catalog/8821/primary.jpg",
  "parentCategoryId": 12,
  "categoryId": 47,
  "categories": ["Audio", "AV Receivers"],
  "isFavorite": false,
  "isDiscontinued": false,
  "rank": 1,
  "msrp": {
    "msrpUsd": 1299.00,
    "value": 1299.00,
    "regularValue": 1299.00,
    "isCustom": false,
    "currency": { "code": "USD", "symbol": "$" },
    "lastModifiedDate": "2026-01-15T00:00:00Z"
  },
  "defaultCost": {
    "supplierName": "D&H Distributing",
    "supplierSku": "AVR-X3800H",
    "managePriceStatus": "Activated",
    "accountNumber": "DH-12345",
    "isInStock": true,
    "isPromo": false,
    "lastVerifiedDate": "2026-04-01T00:00:00Z",
    "unitOfMeasure": "Each",
    "discountPercentage": 0,
    "regularValue": 975.00,
    "isCustom": false,
    "value": 975.00,
    "lastModifiedDate": "2026-04-01T00:00:00Z",
    "currency": { "code": "USD", "symbol": "$" }
  },
  "sellPrice": {
    "type": "CostMultiplier",
    "costMultiplier": 1.4,
    "value": 1365.00,
    "lastModifiedDate": "2026-03-01T00:00:00Z",
    "currency": { "code": "USD", "symbol": "$" }
  }
}

Headers

Accept
enum<string>
required

Accept Header

Available options:
application/json
X-MSS-API-APPID
string
required

Application Id

X-MSS-CUSTOM-DATE
string
required

A date timestamp of the request

X-MSS-SIGNATURE
string
required

A signature for the request

X-MSS-API-USERKEY
string
required

User API Key

Path Parameters

ItemId
integer<int32>
required

Item Id

Query Parameters

ExtendedDetails
boolean

Provides additional details like full description, specs, linked resources

ItemType
string

Response

Success

Full catalog item detail model

id
integer<int32>
required

Unique part identifier.

parentCategoryId
integer<int32>
required

Parent category identifier.

categoryId
integer<int32>
required

Leaf category identifier.

categories
string[]
required

Category breadcrumb or category labels associated with the item.

isFavorite
boolean
required

Whether the item is marked as a favorite for the authenticated account.

isDiscontinued
boolean
required

Whether the item is discontinued.

description
string

Long description of the catalog item

productUrl
string

Portal product page URL when available

manufacturerProductUrl
string

Manufacturer product page URL when available

additionalImageUrls
string[]

Additional image URLs for the catalog item

Linked PDF resources for the catalog item

Linked video resources for the catalog item

specs
PublicSpecDetailsModel · object[]

Specification name/value pairs for the catalog item

suppliers
PublicSupplierInfoModel · object[]

Supplier-specific entries available for this catalog item

brand
string

Brand or manufacturer name.

model
string

Model number.

shortDescription
string

Short description shown in search results.

primaryImageUrl
string

Primary image URL for the catalog item.

msrp
PublicMsrpModel · object

MSRP information returned for a catalog item.

defaultCost
PublicSupplierPriceModel · object

Supplier-specific cost information for a catalog item.

sellPrice
PublicSellPriceModel · object

Sell-price information returned for a catalog item.

rank
integer<int32>

Item rank within the search result ordering.