List Catalog Vendors

GET /catalog-vendors

Returns a paginated list of application vendors. Use this endpoint to populate vendor filter dropdowns in the catalog UI.

Query Parameters

Parameter	Type	Default	Description
q	string	-	Search filter against name (case-insensitive, partial match)
sort_by	string	name	Sort field: name
sort_order	string	asc	Sort direction: asc, desc
page_size	integer	50	Items per page. Max: 500
cursor	string	-	Pagination cursor from a previous response

Response

Field	Type	Description
data	CatalogVendor[]	Array of vendor objects
total_count	integer	Total number of vendors matching the current filters
next_cursor	string | null	Cursor to pass as cursor for the next page. null when on the last page.

Example Request

curl -X GET "https://api.example.com/v2/catalog-vendors" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Search by name

curl -X GET "https://api.example.com/v2/catalog-vendors?q=google" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Example Response

{
  "data": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Google LLC",
      "url": "https://about.google"
    },
    {
      "id": "f6a7b8c9-d0e1-2345-fabc-678901234567",
      "name": "Microsoft Corporation",
      "url": "https://www.microsoft.com"
    },
    {
      "id": "a7b8c9d0-e1f2-3456-abcd-789012345678",
      "name": "Salesforce, Inc.",
      "url": "https://www.salesforce.com"
    }
  ],
  "total_count": 87,
  "next_cursor": "eyJsYXN0X2lkIjoiYTdiOGM5ZDAifQ"
}

Empty Result

{
  "data": [],
  "total_count": 0,
  "next_cursor": null
}

Pagination

This endpoint uses cursor-based pagination.

1. Omit cursor on the first request
2. If next_cursor is not null, pass its value as cursor on the next request
3. Repeat until next_cursor is null

Error Responses

Status	Description
400	Invalid query parameters
401	Authentication required
403	Insufficient permissions
500	Server error

Related Endpoints

• List Catalog Apps - Browse catalog apps (includes embedded vendor)