Skip to main content

Get

You can use the get catalogs API to get the catalogs details.

Request parameters

NameTypeRequired/OptionalDescription
catalogIdsstring[]RequiredList of catalog ids

Request Information

CategoryValue
Http requestPOST
URLhttps://bikapi.bikayi.app/integrations/bikPlatformFunctions-catalogs/get

Sample request

curl --location 'https://bikapi.bikayi.app/integrations/bikPlatformFunctions-catalogs/get' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic AUTH_TOKEN' \
--data '{
"catalogIds": ["453047550251"]
}'

JSON response example:

{
"status": 200,
"success": true,
"data": {
"catalogs": [
{
"image": null,
"isSmartCollection": true,
"name": "Necklace",
"handle": "necklace",
"id": "453047550251",
"isPrivate": true,
"isHidden": true,
"description": "Explore collection of all our necklaces"
}
]
}
}

Response parameters

NameTypeDescription
statusnumberResponse status
successbooleanIs successful response or not
dataBikCatalogsList of catalogs

BikCatalog Type

NameTypeDescription
idstringCatalog ID
namestringName of the catalog
descriptionstringCatalog description
imagestringCatalog image
handlestringCatalog handle
isSmartCollectionbooleanIs the catalog is a smart collection or not
isPrivatebooleanIs the catalog is private
isHiddenbooleanIs the catalog is hidden

Errors

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

Error response example:

{
"status": 400,
"errors": [
{
"message": "'catalogIds' is required."
}
]
}