POST
/
carts
/
search
curl --request POST \
  --url https://api.fabric.inc/v3/carts/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-fabric-tenant-id: <x-fabric-tenant-id>' \
  --data '{
  "limit": 100,
  "offset": 0,
  "filter": {
    "status": [
      "ACTIVE"
    ],
    "orderNumber": "10001",
    "customer": {
      "id": "109840938",
      "sessionId": "3a5fd2d3-5c96-4e57-b069-7ff2a88c1119"
    },
    "promotionTitles": [
      "PROMO_TEST"
    ],
    "updatedAt": {
      "start": "2023-06-13T16:50:00.682Z",
      "end": "2024-06-13T16:50:00.682Z"
    },
    "createdAt": {
      "start": "2023-06-13T16:50:00.682Z",
      "end": "2024-06-13T16:50:00.682Z"
    },
    "channels": [
      "12"
    ]
  }
}'
{
  "query": {
    "limit": 100,
    "offset": 0,
    "total": 1
  },
  "data": [
    {
      "id": "c86f777b-1885-4ddf-961d-542ba80a69b8",
      "attributes": {
        "name": "wishlist"
      },
      "configuration": {
        "order": {
          "validate": {
            "paymentsRemaining": "BLOCK",
            "taxRemaining": "BLOCK",
            "invalidItem": "BLOCK",
            "itemOutOfStock": "BLOCK"
          }
        },
        "product": {
          "cacheExpiry": 7776000,
          "behaviors": {
            "add": "REJECT",
            "update": "WARN",
            "get": "WARN",
            "cacheExpiry": "WARN"
          },
          "maxQuantity": {
            "limit": 100,
            "behaviors": {
              "add": "REJECT",
              "update": "WARN",
              "get": "WARN"
            }
          }
        },
        "inventory": {
          "cacheExpiry": 7776000,
          "behaviors": {
            "add": "REJECT",
            "update": "WARN",
            "get": "WARN",
            "cacheExpiry": "WARN"
          },
          "check": "SKU"
        },
        "tax": {
          "cacheExpiry": 7776000,
          "behaviors": {
            "cacheExpiry": "WARN"
          }
        },
        "promotions": {
          "cacheExpiry": 7776000,
          "behaviors": {
            "cacheExpiry": "WARN"
          }
        },
        "maxQuantity": {
          "limit": 100,
          "behaviors": {
            "add": "REJECT",
            "update": "WARN",
            "get": "WARN"
          }
        }
      },
      "customerContext": {
        "id": "109840938",
        "segments": [
          {
            "name": "membership",
            "value": [
              "gold",
              "silver"
            ]
          }
        ],
        "attributes": {
          "email": "test@gmail.com"
        },
        "sessionId": "3a5fd2d3-5c96-4e57-b069-7ff2a88c1119"
      },
      "status": "ACTIVE",
      "state": [
        {
          "resource": "CART",
          "resourceId": "c86f777b-1885-4ddf-961d-542ba80a69b8",
          "key": "MISSING_PAYMENT_DETAILS",
          "description": "No payment details have been added to this Cart"
        }
      ],
      "price": {
        "total": 800,
        "subtotal": 750,
        "tax": 20,
        "fulfillments": 25,
        "discounts": 10,
        "fees": 5,
        "adjustments": 10
      },
      "promotions": {
        "total": 32,
        "collection": [
          {
            "id": "542ba80a69b8",
            "title": "15 Percent All Products",
            "code": "15_PERCENT",
            "type": "PERCENTAGE",
            "value": 15,
            "attributes": {
              "source": "cart"
            }
          }
        ]
      },
      "fees": {
        "total": 5,
        "collection": [
          {
            "id": "a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93",
            "name": "Eco Fee",
            "price": {
              "amount": 12.99
            },
            "taxable": true,
            "attributes": {
              "source": "eco"
            },
            "tax": {
              "total": 3,
              "collection": [
                {
                  "amount": 3,
                  "attributes": {
                    "rate": "5.0",
                    "type": "COUNTY"
                  }
                }
              ]
            },
            "updatedAt": "2024-06-13T16:50:00.682Z",
            "createdAt": "2024-06-13T16:50:00.682Z",
            "taxDetails": {
              "destinationAddress": "c86f777b-1885-4ddf-961d-542ba80a69b8",
              "originAddress": "c86f777b-1885-4ddf-961d-542ba80a69b8"
            }
          }
        ]
      },
      "adjustments": {
        "total": 2,
        "collection": [
          {
            "id": "a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93",
            "price": {
              "amount": 12.99
            },
            "reason": "Price adjustment from customer representative.",
            "attributes": {
              "source": "CSR"
            },
            "updatedAt": "2024-06-13T16:50:00.682Z",
            "createdAt": "2024-06-13T16:50:00.682Z"
          }
        ]
      },
      "addresses": {
        "a8577d7f0d4d4b228e857b4a2e90dc93": {
          "id": "a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93",
          "name": {
            "first": "John",
            "middle": "S",
            "last": "Doe"
          },
          "email": "john@test.com",
          "phone": {
            "number": "123-456-7890",
            "type": "MOBILE"
          },
          "addressLine1": "123 Park Road",
          "addressLine2": "<string>",
          "addressLine3": "<string>",
          "addressLine4": "<string>",
          "city": "Santa Cruz",
          "region": "California",
          "country": "USA",
          "postalCode": "12345",
          "updatedAt": "2024-06-13T16:50:00.682Z",
          "createdAt": "2024-06-13T16:50:00.682Z"
        }
      },
      "lineItems": {
        "total": 100,
        "collection": [
          {
            "id": "a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93",
            "sku": "SKU3",
            "refId": "41",
            "quantity": 10,
            "priceListId": "10001",
            "position": 1,
            "price": {
              "unit": 10,
              "amount": 100
            },
            "fees": {
              "total": 5,
              "collection": [
                {
                  "id": "a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93",
                  "name": "Eco Fee",
                  "price": {
                    "amount": 12.99
                  },
                  "taxable": true,
                  "attributes": {
                    "source": "eco"
                  },
                  "tax": {
                    "total": 3,
                    "collection": [
                      {
                        "amount": 3,
                        "attributes": {
                          "rate": "5.0",
                          "type": "COUNTY"
                        }
                      }
                    ]
                  },
                  "updatedAt": "2024-06-13T16:50:00.682Z",
                  "createdAt": "2024-06-13T16:50:00.682Z",
                  "taxDetails": {
                    "destinationAddress": "c86f777b-1885-4ddf-961d-542ba80a69b8",
                    "originAddress": "c86f777b-1885-4ddf-961d-542ba80a69b8"
                  }
                }
              ]
            },
            "promotions": {
              "total": 2,
              "collection": [
                {
                  "id": "bb44db95-6fbd-4eed-a1ed-4d99bc91250f",
                  "amount": 15,
                  "quantity": 3,
                  "proration": {
                    "spread": [
                      {
                        "amount": 5,
                        "quantity": 3
                      }
                    ]
                  }
                }
              ]
            },
            "adjustments": {
              "total": 2,
              "collection": [
                {
                  "id": "a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93",
                  "price": {
                    "amount": 12.99
                  },
                  "reason": "Price adjustment from customer representative.",
                  "attributes": {
                    "source": "CSR"
                  },
                  "updatedAt": "2024-06-13T16:50:00.682Z",
                  "createdAt": "2024-06-13T16:50:00.682Z"
                }
              ]
            },
            "fulfillment": {
              "id": "6d65755f-b1d9-4c9d-bb5b-118d317f8db4",
              "price": {
                "amount": 12.99
              },
              "inventory": {
                "type": "backOrder",
                "channels": {
                  "networkCode": "ShipToHome"
                }
              },
              "tax": {
                "total": 3,
                "collection": [
                  {
                    "amount": 3,
                    "attributes": {
                      "rate": "5.0",
                      "type": "COUNTY"
                    }
                  }
                ]
              }
            },
            "attributes": {
              "name": "item-custom"
            },
            "tax": {
              "total": 3,
              "collection": [
                {
                  "amount": 3,
                  "attributes": {
                    "rate": "5.0",
                    "type": "COUNTY"
                  }
                }
              ]
            },
            "taxCode": "10001",
            "updatedAt": "2024-06-13T16:50:00.682Z",
            "createdAt": "2024-06-13T16:50:00.682Z"
          }
        ]
      },
      "summary": {
        "totalItems": 1,
        "totalUniqueItems": 1
      },
      "fulfillments": {
        "d6229cdb0c5b4885b1b213b94d02488e": {
          "id": "d6229cdb-0c5b-4885-b1b2-13b94d02488e",
          "type": "SHIP_TO",
          "refId": "398427903843",
          "attributes": {
            "source": "store"
          },
          "originAddress": "a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93",
          "destinationAddress": "a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93",
          "locationId": "CA",
          "pickupPerson": {
            "primary": {
              "name": {
                "first": "John",
                "middle": "S",
                "last": "Doe"
              },
              "email": "john@test.com",
              "phone": {
                "number": "123-456-7890",
                "type": "MOBILE"
              }
            },
            "secondary": [
              {
                "name": {
                  "first": "John",
                  "middle": "S",
                  "last": "Doe"
                },
                "email": "john@test.com",
                "phone": {
                  "number": "123-456-7890",
                  "type": "MOBILE"
                }
              }
            ]
          },
          "price": {
            "amount": 12.99
          },
          "promotions": {
            "total": 15,
            "collection": [
              {
                "id": "bb44db95-6fbd-4eed-a1ed-4d99bc91250f",
                "amount": 15
              }
            ]
          },
          "fees": {
            "total": 5,
            "collection": [
              {
                "id": "a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93",
                "name": "Eco Fee",
                "price": {
                  "amount": 12.99
                },
                "taxable": true,
                "attributes": {
                  "source": "eco"
                },
                "tax": {
                  "total": 3,
                  "collection": [
                    {
                      "amount": 3,
                      "attributes": {
                        "rate": "5.0",
                        "type": "COUNTY"
                      }
                    }
                  ]
                },
                "updatedAt": "2024-06-13T16:50:00.682Z",
                "createdAt": "2024-06-13T16:50:00.682Z",
                "taxDetails": {
                  "destinationAddress": "c86f777b-1885-4ddf-961d-542ba80a69b8",
                  "originAddress": "c86f777b-1885-4ddf-961d-542ba80a69b8"
                }
              }
            ]
          },
          "adjustments": {
            "total": 2,
            "collection": [
              {
                "id": "a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93",
                "price": {
                  "amount": 12.99
                },
                "reason": "Price adjustment from customer representative.",
                "attributes": {
                  "source": "CSR"
                },
                "updatedAt": "2024-06-13T16:50:00.682Z",
                "createdAt": "2024-06-13T16:50:00.682Z"
              }
            ]
          },
          "tax": {
            "total": 3,
            "collection": [
              {
                "amount": 3,
                "attributes": {
                  "rate": "5.0",
                  "type": "COUNTY"
                }
              }
            ]
          }
        }
      },
      "coupons": [
        {
          "code": "VALID_COUPON",
          "updatedAt": "2024-06-13T16:50:00.682Z"
        }
      ],
      "appliedCoupons": [
        {
          "code": "VALID_COUPON",
          "updatedAt": "2024-06-13T16:50:00.682Z"
        }
      ],
      "notAppliedCoupons": [
        {
          "code": "VALID_COUPON",
          "updatedAt": "2024-06-13T16:50:00.682Z"
        }
      ],
      "validations": {
        "promotions": {
          "updatedAt": "2024-06-13T16:50:00.682Z",
          "appliedCoupons": [
            "TEST_COUPON"
          ],
          "refreshRequired": false
        },
        "lineItems": [
          {
            "sku": "SKU3",
            "inventory": {
              "channels": {
                "networkCode": "ShipToHome"
              },
              "counters": {
                "backOrder": 15,
                "preOrder": 100
              },
              "updatedAt": "2024-06-13T16:50:00.682Z"
            }
          }
        ],
        "product": {
          "availableSkus": [
            {
              "sku": "SKU3",
              "updatedAt": "2024-06-13T16:50:00.682Z",
              "maxQuantity": 100
            }
          ]
        },
        "tax": {
          "updatedAt": "2024-06-13T16:50:00.682Z"
        }
      },
      "payments": {
        "authorized": 800,
        "collection": [
          {
            "id": "6ef2067a-5d6b-4785-a090-96ea0078220d",
            "provider": "verifone",
            "processor": "stripe",
            "method": "apple pay",
            "methodType": "credit card",
            "state": "PENDING",
            "authorization": {
              "amount": 8,
              "expiry": "2024-06-13T16:50:00.682Z",
              "verifier": {
                "type": "TOKEN",
                "key": "CH39082K439R0"
              }
            },
            "billToAddress": "a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93",
            "cardDetails": {},
            "attributes": {
              "gift-card-name": "custom name"
            }
          }
        ]
      },
      "channelId": "12",
      "currency": "USD",
      "updatedAt": "2024-06-13T16:50:00.682Z",
      "createdAt": "2024-06-13T16:50:00.682Z"
    }
  ]
}

Authorizations

Authorization
string
header
required

This is the authorization token used to authenticate the request. You must pass the access token generated from the system app. For more information, see the Making your first API request section.

Headers

x-fabric-tenant-id
string
required

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

x-fabric-request-id
string

Unique request ID for tracking.

x-fabric-channel-id
string

x-fabric-channel-id identifies the sales channel through which the API request is being made; primarily for multichannel use cases. It is a required field. The default US channel is 12 while the default Canada channel is 11.

Body

application/json

Search Cart Request

limit
integer
required

The maximum number of carts returned.

Required range: x > 1
offset
integer
required

The starting point for the records returned from the database.

Required range: x > 0
filter
object

Filters used to customize the carts returned.

Response

200
application/json
OK

Search Cart Response

query
object
required

Query details

data
object[]
required

List of carts returned