Customers - Rutter API Reference - the Common Language for Business Data

The Customer object

A Rutter Customer represents a consumer that has interacted with or purchased products from the merchant's store. Every order is linked to Orders made by the customer.

For customers from an accounting platform, see Customers.

Properties

idstringnullable

The Rutter generated unique ID of the customer.

platform_idstringnullableoptional

The platform specific ID of the customer.

emailstringnullable

The email of the customer.

first_namestringnullable

The first name of the customer.

last_namestringnullable

The last name of the customer.

phonestringnullable

The phone number of the customer.

ordersarray

An array of Rutter IDs of Orders linked to the customer.

Show orders attributes

created_atstring

The ISO 8601 timestamp that the customer was created.

updated_atstring

The ISO 8601 timestamp that the customer was last updated.

Example Customer Object

{
  "id": "00000000-0000-0000-0000-000000000000",
  "platform_id": "12345678",
  "email": "eric@rutter.com",
  "first_name": "Eric",
  "last_name": "Yu",
  "phone": "1234567890",
  "orders": [
    {
      "id": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "created_at": "2023-01-02T02:34:56.000Z",
  "updated_at": "2023-01-02T02:34:56.000Z"
}

List Customers

GET /customers

Supported for: AmazonBigCommerceChargebeeChargifyMagentoMercado LibrePrestaShopShopeeShopifySquareSquarespaceStripeWooCommerce

Request Parameters

access_tokenstringquery

The access token of the connection.

cursorstringoptionalquery

The cursor to use for pagination. This value is passed in from next_cursor field in a previous request.

emailstringoptionalquery

An email to filter on.

force_fetchenumoptionalquery

Force a response even if the underlying connection hasn't finished the initial sync.

One oftrue or false.

limitintegeroptionalquery

The limit on the number of entities returned.

phonestringoptionalquery

A phone number formatted using only numerics to filter on.

updated_at_maxintegeroptionalquery

The Unix Timestamp in milliseconds maximum updated_at datetime to fetch entities from.

updated_at_minintegeroptionalquery

The Unix Timestamp in milliseconds minimum updated_at datetime to fetch entities from.

Response Body

connectionobject

Show connection attributes

customersarray

Show customers attributes

next_cursorstringnullable

Example Response Body

{
  "connection": {
    "id": "00000000-0000-0000-0000-000000000000",
    "orgId": "00000000-0000-0000-0000-000000000000",
    "platform": "SHOPIFY"
  },
  "customers": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "platform_id": "12345678",
      "email": "eric@rutter.com",
      "first_name": "Eric",
      "last_name": "Yu",
      "phone": "1234567890",
      "orders": [
        {
          "id": "00000000-0000-0000-0000-000000000000"
        }
      ],
      "created_at": "2023-01-02T02:34:56.000Z",
      "updated_at": "2023-01-02T02:34:56.000Z"
    }
  ],
  "next_cursor": "MTY3NDgzMTk0Ml82MDY4ZDI0ZC02NGRmLTRmN2EtYTM0Ny0zN2ZmNjY5MGVmMjU="
}

Fetch a Customer

GET /customers/:id

Supported for: AmazonBigCommerceChargifyMagentoMercado LibrePrestaShopShopifySquareSquarespaceWooCommerce