Skip to main content
Version: Unstable

Product Price Table Customers

This documentation explains how to associate and disassociate customers with a product price table, allowing merchants to control which customers have access to specific pricing rules and discounts.

Customer Properties​

PropertyExplanation
idThe unique identifier for the customer
created_atTimestamp when the customer was associated to product price table in ISO 8601 format
approved_atTimestamp when the customer was approved to product price table association in ISO 8601 format (nullable)

Endpoints​

PUT /products/price-tables/{id}/customers​

Updates one or more customers in a product price table.

PUT /products/price-tables/1/customers​

["123456789", "654987321", "456897321"]

HTTP/1.1 204 No Content

{}

POST /products/price-tables/{id}/approve-customers​

Approve one or more customers in a product price table.

POST /products/price-tables/1/approve-customers​

["123456789", "654987321", "456897321"]

HTTP/1.1 204 No Content

{}

GET /products/price-tables/customers/{id}​

Returns a paginated list of product price tables associated with a customer.

ParameterExplanation
pagePage to show
per_pageAmount of results

GET /products/price-tables/customers/123456789?page=1&per_page=10​

HTTP/1.1 200 Ok

{
  "total": 1,
  "page": 1,
  "price_tables": [
    {
      "id": "1",
      "verification_code": "5a23d45e-52b4-470f-8cf8-ff959b9ef0fa",
      "store_id": "3776871",
      "name": "Price Table",
      "default_discount": "7.00",
      "cart_minimum_price": "250.00",
      "cart_minimum_quantity": 30,
      "auto_approve_customers": true,
      "active": true,
      "created_at": "2025-11-17T15:12:39.396Z",
      "updated_at": "2025-11-23T12:48:52.132Z",
      "has_categories": true,
      "has_products_variants": false,
      "has_customers": true
    }
  ]
}

GET /products/price-tables/{id}/customers​

Returns a paginated list of customers from the product price table.

ParameterExplanation
pagePage to show
per_pageAmount of results

GET /products/price-tables/1/customers?page=1&per_page=50​

HTTP/1.1 200 Ok

{
  "total": 4,
  "page": 1,
  "price_table": {
    "id": "1",
    "verification_code": "5a23d45e-52b4-470f-8cf8-ff959b9ef0fa",
    "store_id": "3776871",
    "name": "Price Table",
    "default_discount": "7.00",
    "cart_minimum_price": "250.00",
    "cart_minimum_quantity": 30,
    "auto_approve_customers": true,
    "active": true,
    "created_at": "2025-11-17T15:12:39.396Z",
    "updated_at": "2025-11-23T12:48:52.132Z",
    "has_categories": true,
    "has_products_variants": false,
    "has_customers": true,
    "customers": [
      {
        "id": "123456789",
        "created_at": "2026-04-10T19:10:18.795Z",
        "approved_at": "2026-04-22T17:56:42.924Z"
      },
      {
        "id": "987654321",
        "created_at": "2026-04-11T19:10:18.795Z",
        "approved_at": "2026-04-22T17:56:42.924Z"
      },
      {
        "id": "789456321",
        "created_at": "2026-04-12T19:10:18.795Z",
        "approved_at": "2026-04-22T17:56:42.924Z"
      },
      {
        "id": "654987321",
        "created_at": "2026-04-13T19:10:18.795Z",
        "approved_at": "2026-04-22T17:56:42.924Z"
      }
    ]
  }
}

DELETE /products/price-tables/{id}/customers/{id}​

Delete a specific customer from a product price table.

DELETE /products/price-tables/1/customers/987654321​

HTTP/1.1 204 No Content

{}

FAQ​

How to create a Product Price Table?

In this case, see the documentation on how to configure the discount in a specific product and variant for a product price table (link with documentation).

Last updated on