GET
/
admin
/
customers
import Medusa from "@medusajs/js-sdk"

export const sdk = new Medusa({
  baseUrl: import.meta.env.VITE_BACKEND_URL || "/",
  debug: import.meta.env.DEV,
  auth: {
    type: "session",
  },
})

sdk.admin.customer.list()
.then(({ customers, count, limit, offset }) => {
  console.log(customers)
})
{
  "limit": 123,
  "offset": 123,
  "count": 123,
  "customers": {
    "id": "<string>",
    "has_account": true,
    "groups": [
      {
        "id": "<string>",
        "name": "<string>",
        "customers": [
          {}
        ],
        "metadata": {},
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "email": "jsmith@example.com",
    "default_billing_address_id": "<string>",
    "default_shipping_address_id": "<string>",
    "company_name": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "addresses": [
      {
        "id": "<string>",
        "address_name": "<string>",
        "is_default_shipping": true,
        "is_default_billing": true,
        "customer_id": "<string>",
        "company": "<string>",
        "first_name": "<string>",
        "last_name": "<string>",
        "address_1": "<string>",
        "address_2": "<string>",
        "city": "<string>",
        "country_code": "us",
        "province": "us-ca",
        "postal_code": "<string>",
        "phone": "<string>",
        "metadata": {},
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "phone": "<string>",
    "metadata": {},
    "created_by": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "deleted_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
fields
string

Comma-separated fields that should be included in the returned data. if a field is prefixed with + it will be added to the default fields, using - will remove it from the default fields. without prefix it will replace the entire default fields. This API route restricts the fields that can be selected. Learn how to override the retrievable fields in the Retrieve Custom Links documentation.

​
offset
number

The number of items to skip when retrieving a list.

​
limit
number

Limit the number of items returned in the list.

​
order
string

The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with -.

​
groups

Filter by a customer group's ID to retrieve customers that belong to it.

​
q
string

Search term to filter the customer's searchable properties by.

​
id

Filter by a customer's ID.

​
email

Filter by a customer email.

​
company_name

Filter by a customer's company name.

​
first_name

Filter by a customer's first name.

​
last_name

Filter by a customer's last name.

​
created_by

Filter by a user ID to retrieve the customers they created.

​
created_at
object

Filter by the customer's creation date.

​
updated_at
object

Filter by a customer's update date.

​
deleted_at
object

Filter a customer by their deletion date.

​
$and
$and · object[]

Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters.

​
$or
$or · object[]

Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters.

​
has_account
boolean

Filter by whether the customer is registered.

​
with_deleted
boolean

Whether to include deleted records in the result.

Response

200
application/json

OK

The paginated list of customers.