# List catalog listings

**GET /api/external/hub/v1/catalog/listings**

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


## Servers
- Public API: https://api.useshelf.com (Public API)



## Parameters


### Query parameters
- **page** (integer)
  Page number for pagination
- **per_page** (integer)
  Number of listings per page (default: 100)


## Responses
### 200
catalog listings retrieved successfully

#### Body: application/json (array[object])
- **id** (integer)
  Listing ID
- **listing_mp_primary_id** (string)
  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


[Powered by Bump.sh](https://bump.sh)