Skip to main content

​
Overview

List all merchant SKUs with optional filtering by update date. Results are paginated using a token-based pagination system.

​
List Merchant SKUs

Retrieve a paginated list of your SKUs. You can filter by last update date to retrieve only recently modified SKUs. 
curl -X GET 'https://product.api.e-cross.tech/ext/merchant/skus?lastUpdateDateFrom=2025-10-06T00:00:00.000Z&nextPageToken=' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "skus": [
    {
      "merchantProductId": "ACME-1234567",
      "localizedSalePriceWithTaxes": 9.99,
      "skuId": "1234567891",
      "name": "USB charger type C",
      "weight": 0.1,
      "ean": "0799439112767",
      "lastUpdateDate": "2025-10-06T19:28:17.463Z",
      "length": 19,
      "width": 4,
      "height": 4,
      "images": [
        "https://image-host/1234567/1.jpeg"
      ],
      "main": true,
      "globalSaleChannelData": {
        "size": "1 meter",
        "color": "silver",
        "active": true,
        "brand": "ChargerW",
        "category": "Telefones e Celulares/Acessórios/Carregadores",
        "attributes": [
          {
            "name": "Connection Type",
            "value": "USB-C"
          }
        ]
      },
      "description": "Beautiful and reliable super fast USB Type C charger.",
      "id": "ACME-1234567891",
      "productId": "1234567",
      "merchantId": "ACME",
      "salesChannelStatus": {
        "ECOM": {
          "statusDate": "2024-09-06T11:13:30.533Z",
          "statusMessage": "Integration successful",
          "status": "SALES_CHANNEL_APPROVED"
        }
      }
    }
  ],
  "nextPageToken": "eyJ0eXBlIjoibWFzdGVyIiwibG9jYWxpemF0aW9uU3RhdHVzIjoiUkVBRFlfRk9SX1NBTEVTX0NIQU5ORUwiLCJpZCI6IkFMSEFNQVMtNDQ5NTg4NDI2ODM1NTEiLCJtZXJjaGFudElkIjoiQUxIQU1BUyJ9"
}

​
Query Parameters

​
lastUpdateDateFrom
string
Return only SKUs updated after this date. Must be in ISO 8601 format (e.g., 2025-10-06T00:00:00.000Z). If not provided, all SKUs are returned.
​
nextPageToken
string
The token to fetch the next page of results. Use the value returned in the nextPageToken field of the previous request. If there are no more results, this field won’t be returned in the response.

​
Response Fields

​
skus
array
required
Array containing SKUs that match the provided filters. Each SKU object has the same structure as defined in the Catalog Integration endpoint.
​
nextPageToken
string
The token to be used in the query parameter to retrieve the next page of results. If there are no more results, this field won’t be returned.

​
Pagination

This endpoint uses token-based pagination:
  1. Make your first request without nextPageToken
  2. If the response includes nextPageToken, use it in the nextPageToken query parameter for the next request
  3. Repeat until no nextPageToken is returned
# First page
curl -X GET 'https://product.api.e-cross.tech/ext/merchant/skus' \
  -H 'Authorization: Bearer YOUR_TOKEN'

# Next page (using token from previous response)
curl -X GET 'https://product.api.e-cross.tech/ext/merchant/skus?nextPageToken=TOKEN_FROM_PREVIOUS_RESPONSE' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Use the lastUpdateDateFrom parameter to synchronize only recently updated SKUs, reducing the amount of data transferred.

Get SKU by Product

Next: Learn how to retrieve SKUs for a specific product