emfasemfas

List variants

Returns a paginated list of variants. Each variant's attributes map merges the parent product's attributes into the variant's (each keyed by entity prefix).

GET
/variants

Authorization

Authorization<token>

API key authentication using Bearer token format. Use: Bearer

In: header

Query Parameters

updated_after?string

Returns variants whose response data has changed since this timestamp (RFC3339), including parent product or descendant SKU changes

search?string

JSON search filters keyed by attribute key — see filtering reference

search_mode?string

Filter match mode

Default"\"all\""
Value in"all" | "any"
include?string

Relations to embed; metaobjects sideloads referenced metaobjects under included

limit?integer

Results per page

Default100
Range1 <= value <= 200
page?integer

Page number (1-based)

Default1
Range1 <= value

Response Body

curl -X GET "https://api.emfas.ai/v1/variants?updated_after=string&search=string&search_mode=all&include=string&limit=100&page=1"
{
  "included": [
    {
      "attributes": {
        "property1": [
          {
            "data": null,
            "locale": "en-US",
            "metaobjectDefinition": "gender",
            "type": "text",
            "value": "Space Black"
          }
        ],
        "property2": [
          {
            "data": null,
            "locale": "en-US",
            "metaobjectDefinition": "gender",
            "type": "text",
            "value": "Space Black"
          }
        ]
      },
      "definition": "brand",
      "identifier": "nike",
      "name": "Nike",
      "type": "metaobject",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "limit": 100,
    "page": 1,
    "totalPages": 3,
    "totalResults": 234
  },
  "result": [
    {
      "attributes": {
        "property1": [
          {
            "data": null,
            "locale": "en-US",
            "metaobjectDefinition": "gender",
            "type": "text",
            "value": "Space Black"
          }
        ],
        "property2": [
          {
            "data": null,
            "locale": "en-US",
            "metaobjectDefinition": "gender",
            "type": "text",
            "value": "Space Black"
          }
        ]
      },
      "identifier": "VAR-001",
      "name": "iPhone 14 Pro 256GB",
      "product": {
        "identifier": "PROD-001",
        "name": "iPhone 14 Pro"
      },
      "selfUpdatedAt": "2024-01-15T10:30:00Z",
      "skus": [
        {
          "attributes": {
            "property1": [
              {
                "data": null,
                "locale": "en-US",
                "metaobjectDefinition": "gender",
                "type": "text",
                "value": "Space Black"
              }
            ],
            "property2": [
              {
                "data": null,
                "locale": "en-US",
                "metaobjectDefinition": "gender",
                "type": "text",
                "value": "Space Black"
              }
            ]
          },
          "identifier": "SKU-001",
          "name": "Small-Blue",
          "selfUpdatedAt": "2024-01-15T10:30:00Z",
          "updatedAt": "2024-01-15T10:30:00Z"
        }
      ],
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ]
}
{
  "error": "Internal server error"
}
{
  "error": "Internal server error"
}
{
  "error": "Internal server error"
}