get_all_customers

get_all_customers

Retrieve all customer data from BigCommerce with advanced filtering by email, name, company, phone, dates, and customer groups for comprehensive customer management.

Instructions

Get all customers from the BigCommerce API with comprehensive filtering options (email, name, company, phone, customer group, dates, pagination). Store hash is automatically retrieved from environment variables.

Input Schema

Name	Required	Description
`company`	No	Filter by company name (exact match).
`customer_group_id`	No	Filter by customer group ID (comma-separated for multiple groups).
`date_created`	No	Filter by exact customer creation date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).
`date_created_max`	No	Filter customers created before this date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).
`date_created_min`	No	Filter customers created after this date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).
`date_modified`	No	Filter by exact customer modification date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).
`date_modified_max`	No	Filter customers modified before this date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).
`date_modified_min`	No	Filter customers modified after this date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).
`email`	No	Filter by customer email address (exact match).
`id`	No	Filter by customer IDs (comma-separated for multiple IDs, e.g., "1,2,3").
`include`	No	Include additional customer sub-resources (comma-separated: addresses, storecredit, attributes, formfields).
`limit`	No	Number of results to return (max 250, default 50).
`name`	No	Filter by customer full name (exact match).
`name_like`	No	Filter by customer name using partial match (substring search).
`page`	No	Page number for pagination (default 1).
`phone`	No	Filter by phone number (exact match).
`registration_ip_address`	No	Filter by registration IP address (exact match).
`sort`	No	Sort field and direction (e.g., "date_created:desc", "last_name:asc", "date_modified:desc").
`store_Hash`	No	Optional store hash. If not provided, uses BIGCOMMERCE_STORE_HASH from environment variables.

Input Schema (JSON Schema)

{
  "properties": {
    "company": {
      "description": "Filter by company name (exact match).",
      "type": "string"
    },
    "customer_group_id": {
      "description": "Filter by customer group ID (comma-separated for multiple groups).",
      "type": "string"
    },
    "date_created": {
      "description": "Filter by exact customer creation date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).",
      "type": "string"
    },
    "date_created_max": {
      "description": "Filter customers created before this date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).",
      "type": "string"
    },
    "date_created_min": {
      "description": "Filter customers created after this date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).",
      "type": "string"
    },
    "date_modified": {
      "description": "Filter by exact customer modification date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).",
      "type": "string"
    },
    "date_modified_max": {
      "description": "Filter customers modified before this date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).",
      "type": "string"
    },
    "date_modified_min": {
      "description": "Filter customers modified after this date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).",
      "type": "string"
    },
    "email": {
      "description": "Filter by customer email address (exact match).",
      "type": "string"
    },
    "id": {
      "description": "Filter by customer IDs (comma-separated for multiple IDs, e.g., \"1,2,3\").",
      "type": "string"
    },
    "include": {
      "description": "Include additional customer sub-resources (comma-separated: addresses, storecredit, attributes, formfields).",
      "type": "string"
    },
    "limit": {
      "description": "Number of results to return (max 250, default 50).",
      "type": "integer"
    },
    "name": {
      "description": "Filter by customer full name (exact match).",
      "type": "string"
    },
    "name_like": {
      "description": "Filter by customer name using partial match (substring search).",
      "type": "string"
    },
    "page": {
      "description": "Page number for pagination (default 1).",
      "type": "integer"
    },
    "phone": {
      "description": "Filter by phone number (exact match).",
      "type": "string"
    },
    "registration_ip_address": {
      "description": "Filter by registration IP address (exact match).",
      "type": "string"
    },
    "sort": {
      "description": "Sort field and direction (e.g., \"date_created:desc\", \"last_name:asc\", \"date_modified:desc\").",
      "type": "string"
    },
    "store_Hash": {
      "description": "Optional store hash. If not provided, uses BIGCOMMERCE_STORE_HASH from environment variables.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

BigCommerce API MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from BigCommerce API MCP Server

Related Tools

MCP directory API