List Catalog Categories - Portal.io API

curl -i -X GET \
  'https://api.portal.io/public/catalog/categories' \
  -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'

[
  {
    "id": 12,
    "name": "Audio",
    "categories": [
      {
        "id": 47,
        "name": "AV Receivers",
        "imageUrl": "https://images.portal.io/categories/47.jpg",
        "subCategories": []
      },
      {
        "id": 48,
        "name": "Amplifiers",
        "imageUrl": null,
        "subCategories": []
      }
    ]
  },
  {
    "id": 13,
    "name": "Video",
    "categories": [
      {
        "id": 60,
        "name": "Displays",
        "imageUrl": "https://images.portal.io/categories/60.jpg",
        "subCategories": [
          {
            "id": 61,
            "name": "4K Displays",
            "imageUrl": null,
            "subCategories": []
          }
        ]
      }
    ]
  }
]

GET

public

catalog

categories

curl -i -X GET \
  'https://api.portal.io/public/catalog/categories' \
  -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'

[
  {
    "id": 12,
    "name": "Audio",
    "categories": [
      {
        "id": 47,
        "name": "AV Receivers",
        "imageUrl": "https://images.portal.io/categories/47.jpg",
        "subCategories": []
      },
      {
        "id": 48,
        "name": "Amplifiers",
        "imageUrl": null,
        "subCategories": []
      }
    ]
  },
  {
    "id": 13,
    "name": "Video",
    "categories": [
      {
        "id": 60,
        "name": "Displays",
        "imageUrl": "https://images.portal.io/categories/60.jpg",
        "subCategories": [
          {
            "id": 61,
            "name": "4K Displays",
            "imageUrl": null,
            "subCategories": []
          }
        ]
      }
    ]
  }
]

Retrieves the complete category tree from the Portal.io catalog. The response is an array of top-level industry objects, each containing a nested categories array with their child categories and optional image URLs. Sub-categories may themselves contain additional subCategories arrays. Use the id values from this response as CategoryId or ParentCategoryId filters when searching catalog items.

The Catalog endpoints require separate authorization. Contact your Portal.io representative to confirm your account has catalog API access enabled.

curl -i -X GET \
  'https://api.portal.io/public/catalog/categories' \
  -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'

[
  {
    "id": 12,
    "name": "Audio",
    "categories": [
      {
        "id": 47,
        "name": "AV Receivers",
        "imageUrl": "https://images.portal.io/categories/47.jpg",
        "subCategories": []
      },
      {
        "id": 48,
        "name": "Amplifiers",
        "imageUrl": null,
        "subCategories": []
      }
    ]
  },
  {
    "id": 13,
    "name": "Video",
    "categories": [
      {
        "id": 60,
        "name": "Displays",
        "imageUrl": "https://images.portal.io/categories/60.jpg",
        "subCategories": [
          {
            "id": 61,
            "name": "4K Displays",
            "imageUrl": null,
            "subCategories": []
          }
        ]
      }
    ]
  }
]

Headers

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

Response

A catalog response

integer<int32>

required

Unique numeric identifier of the industry

name

string

required

Industry display name