Hub API
GET /v1/catalog/listings
Bearer auth

Retrieve a list of catalog listings belonging to the authenticated organization.

Query parameters

  • page integer

    Page number for pagination

  • per_page integer

    Number of listings per page (default: 100)

  • item_id integer

    Filter listings by item ID

Responses

  • 200 application/json

    catalog listings filtered by item_id

    Hide response attributes Show response attributes object
    • id integer Required

      Listing ID

    • listing_mp_primary_id string Required

      Listing marketplace primary ID

    • listing_name string | null

      Listing name

    • marketplace_name string | null

      Marketplace name

    • listing_mp_seller_account_id string | null

      Listing marketplace seller account ID

    • item_id integer | null

      Associated item ID
  • 404 application/json

    item not found or does not belong to organization

    Hide response attribute Show response attribute object
    • error string
GET /v1/catalog/listings 
curl \
 --request GET 'https://api.pattern.com/hub/v1/catalog/listings' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
[
  {
    "id": 42,
    "listing_mp_primary_id": "string",
    "listing_name": "string",
    "marketplace_name": "string",
    "listing_mp_seller_account_id": "string",
    "item_id": 42
  }
]
Response examples (404) 
{
  "error": "string"
}