# Volume Pricing with other API methods

This document explains how to retrieve and delete Volume Pricing records using the Public API.

***

### WHOLESALE PRICING GET API

#### 1. Endpoint

To retrieve a specific Volume Pricing record:

```
GET https://wholesale.samita.io/api/v1/volume-pricings/{id}
```

* `{id}` is the ID of the Volume Pricing record

<figure><img src="https://810149679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7AXvWN0Sv4Sg8s2aVRWp%2Fuploads%2FcKjRGmF8n2jcBsPCvdWo%2Fimage.png?alt=media&#x26;token=eade8bdf-d83b-44e6-94f0-bbbde22b0355" alt=""><figcaption></figcaption></figure>

* The ID can be obtained from the app interface
* Do not include the “#” symbol when using the ID

**Example:**

```
GET https://wholesale.samita.io/api/v1/volume-pricings/1
```

***

#### 2. Request Headers

All GET requests must include the following required headers:

| Header              | Description                                     | Required |
| ------------------- | ----------------------------------------------- | -------- |
| `X-SAMITA-API-KEY`  | API key provided in the Wholesale app           | Yes      |
| `X-SAMITA-SHOP-URL` | Shopify shop domain in format xxx.myshopify.com | Yes      |
| `CONTENT-TYPE`      | Must be `application/json`                      | Yes      |

If any of these headers are missing, the request will be rejected.

***

#### 3. Request Body

* The GET API does **not require a request body**
* Only the `{id}` parameter in the URL is required

***

#### 4. API Response

**4.1 Error Responses**

**401 – Unauthorized**

This error occurs when authentication fails.

Possible reasons:

* Missing shop URL
* Missing API key
* Incorrect shop URL
* Incorrect API key
* API key does not match the provided shop

***

**403 – This action is unauthorized**

This error occurs when:

* The API key does not have View permission
* The provided ID does not exist
* Insufficient access rights for the API key

Each API key can be assigned the following permissions:

* View
* Create
* Update
* Delete

The GET API requires **View** permission.

***

**429 – Too Many Requests**

This error occurs when the rate limit is exceeded.

Current limits:

* Maximum **1 request per 5 minutes**
* Maximum **50 requests per day**

***

**4.2 Success Response**

**200 – API Success**

* The request is valid
* The record is successfully retrieved
* Response is returned in JSON format

Example:&#x20;

```json
{
  "id": 1,
  "title": "New Volume Pricing",
  "status": true,
  "type": "quantity",
  "apply_customer": {
    "type": "all",
    "tags": []
  },
  "exclude_customer": {
    "type": "none",
    "tags": []
  },
  "apply_product": {
    "type": "all",
    "product_ids": [],
    "product_tags": [],
    "collection_ids": [],
    "apply_for_variants": false
  },
  "exclude_product": {
    "type": "none",
    "product_ids": [],
    "collection_ids": []
  },
  "discount_for_variants": [
    {
      "id": 8516448190631,
      "duplicated": false,
      "variant_pricing": true,
      "from_qty": "0",
      "from_amount": "0",
      "to_qty": "10",
      "to_amount": "0",
      "discount_groups": [
        {
          "name": "all",
          "type": "percent",
          "value": "10"
        }
      ],
      "variants": [
        {
          "id": 46747346763943,
          "duplicated": false,
          "from_qty": "0",
          "from_amount": "0",
          "to_qty": "10",
          "to_amount": "0",
          "discount_groups": [
            {
              "name": "all",
              "type": "percent",
              "value": "10"
            }
          ]
        }
      ]
    }
  ],
  "apply_market": {
    "type": "all",
    "handle": []
  },
  "discount_method": "variant",
  "discount_groups": [
    {
      "from_qty": "0",
      "from_amount": "0",
      "to_qty": "10",
      "to_amount": "0",
      "type": "percent",
      "value": "10"
    }
  ],
  "active_date": {
    "types": [],
    "start_at": "",
    "end_at": ""
  },
  "created_at": "2026-01-15T10:00:00",
  "updated_at": "2026-01-15T10:00:00"
}
```

***

## WHOLESALE PRICING DELETE API

#### 1. Endpoint

To delete an existing Volume Pricing record:

```
DELETE https://wholesale.samita.io/api/v1/volume-pricings/{ids}
```

* `{id}` is the ID of the Volume Pricing record
* The ID must be a valid existing record ID

**Example:**

```
DELETE https://wholesale.samita.io/api/v1/volume-pricings/1
```

***

#### 2. Request Headers

All DELETE requests must include the following required headers:

| Header              | Description                                     | Required |
| ------------------- | ----------------------------------------------- | -------- |
| `X-SAMITA-API-KEY`  | API key provided in the Wholesale app           | Yes      |
| `X-SAMITA-SHOP-URL` | Shopify shop domain in format xxx.myshopify.com | Yes      |
| `CONTENT-TYPE`      | Must be `application/json`                      | Yes      |

***

#### 3. Request Body

* The DELETE API does **not require a request body**
* Only the `{id}` in the endpoint URL is required

***

#### 4. API Response

**4.1 Error Responses**

**401 – Unauthorized**

Returned when authentication fails.

Possible reasons:

* Missing shop URL
* Missing API key
* Incorrect shop URL
* Incorrect API key
* API key does not match the shop

***

**403 – This action is unauthorized**

This error occurs when:

* The API key does not have Delete permission
* The provided ID does not exist
* The API key does not have sufficient access rights

The DELETE API requires **Delete** permission.

***

**429 – Too Many Requests**

Returned when the request exceeds the allowed rate limit.

Rate limits:

| Limit Type        | Value                   |
| ----------------- | ----------------------- |
| Request frequency | 1 request per 5 minutes |
| Daily limit       | 50 requests per day     |

***

**4.2 Success Response**

**200 – API Success**

* The Wholesale Pricing record is successfully deleted
* No content or a confirmation message may be returned

Example:&#x20;

```json
{
  "success": true
}
```