Skip to main content
GET
/
api
/
ext
/
v1
/
collection
/
{collectionId}
/
products
List a Collection Products
curl --request GET \
  --url https://staging-api.covver.io/api/ext/v1/collection/{collectionId}/products \
  --header 'Authorization: Bearer <token>'
{
  "isPersonalized": true,
  "creationStatus": "Pending",
  "data": [
    {
      "id": "<string>",
      "title": "<string>",
      "description": "<string>",
      "priceRange": {
        "minVariantPrice": 123,
        "maxVariantPrice": 123
      },
      "retailPriceRange": {
        "minVariantPrice": 123,
        "maxVariantPrice": 123
      },
      "options": [
        {
          "name": "size",
          "values": [
            {
              "title": "<string>",
              "colorCode": "<string>",
              "colorCode2": "<string>"
            }
          ]
        }
      ],
      "isInStock": true,
      "isDiscontinued": true,
      "featuredImage": {
        "url": "<string>",
        "lowResUrl": "<string>",
        "width": 123,
        "height": 123
      },
      "errors": {
        "hasLowResolutionElements": true,
        "hasNonCmykElements": true,
        "hasBaseProductIssue": true,
        "hasNonBlackAndWhiteElements": true,
        "isBlank": true,
        "hasOldPrintAreas": true
      },
      "isPersonalized": false,
      "status": "Active",
      "notes": "<string>",
      "customFields": {}
    }
  ],
  "collection": {
    "id": "<string>",
    "deletedAt": "2023-11-07T05:31:56Z",
    "status": "Active",
    "slug": "<string>",
    "title": "<string>",
    "description": "<string>",
    "image": "<string>",
    "imageMobile": "<string>",
    "rewardType": "Coins",
    "personalizationsUsed": [
      "<string>"
    ]
  },
  "count": 123
}

​
Localization (optional)

Use the accept-language header to get translated strings. Supported locales:
  • en-US (default locale)
  • fr-FR
  • fr-CA
  • es-ES
  • es-MX
  • en-AU
  • en-GB
Examples:
- Accept-Language: *
- Accept-Language: fr
- Accept-Language: fr-FR
- Accept-Language: fr-FR, fr;q=0.9, en;q=0.8, *;q=0.5

​
Statuses

Multiple statuses can be sent as comma separated values
For a personalized collection, poll this API with the same data until status !== 'Pending' (~20 seconds)

Authorizations

​
Authorization
string
header
required

Headers

​
accept-language
string

Path Parameters

​
collectionId
string<uuid>
required

Query Parameters

​
countryCode
string
​
sort
enum<string>
Available options:
priceHighToLow,
priceLowToHigh,
alphabeticalAToZ,
alphabeticalZToA
​
status
string
​
firstName
string | null
​
lastName
string | null
​
department
string | null
​
location
string | null
​
startDate
string<date-time> | null
​
birthDate
string<date-time> | null

Response

​
isPersonalized
boolean
required
​
creationStatus
enum<string>
required
Available options:
Pending,
Done,
Error
​
data
object[]
required
​
collection
object
required
​
count
number
required