List

You can use the list catalogs API to get all the catalogs.

Request parameters

Name	Type	Required/Optional	Description
afterCatalogId	string	Optional	Catalog ID used to fetch catalogs after this in the database

Request Information

Category	Value
Http request	POST
URL	https://bikapi.bikayi.app/integrations/bikPlatformFunctions-catalogs/list

Sample request

curl --location 'https://bikapi.bikayi.app/integrations/bikPlatformFunctions-catalogs/list' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic AUTH_TOKEN' \
--data '{
    "afterCatalogId": "453048500523"
}'

JSON response example:

{
  "status": 200,
  "success": true,
  "data": {
    "catalogs": [
      {
        "image": "https://cdn.shopify.com/s/files/1/0672/6267/7292/collections/Football_Pallo_valmiina-cropped.jpg?v=1713341921",
        "isSmartCollection": true,
        "name": "Bottles",
        "handle": "bottles",
        "id": "473936298284",
        "isPrivate": true,
        "isHidden": true,
        "description": "This is a smart collection with multiple products"
      }
    ]
  }
}

Response parameters

Name	Type	Description
status	number	Response status
success	boolean	Is successful response or not
data	BikCatalogs	List of catalogs

BikCatalog Type

Name	Type	Description
id	string	Catalog ID
name	string	Name of the catalog
description	string	Catalog description
image	string	Catalog image
handle	string	Catalog handle
isSmartCollection	boolean	Is the catalog is a smart collection or not
isPrivate	boolean	Is the catalog is private
isHidden	boolean	Is the catalog is hidden

Errors

Error Code	Meaning
400	Invalid payload -- Your request is invalid.
401	Unauthorized -- User is not authenticated.
404	Not Found -- The specified API could not be found.
500	Internal Server Error -- We had a problem with our server. Try again later.