> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://apidocs.me-mate.net/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.me-mate.net/_mcp/server.

# https://business.me-mate.net/partners/broadcast/delete/taglist

GET https://business.me-mate.net/partners/broadcast/delete/taglist

### Purpose

Deletes one or more **Contact Lists** (a.k.a. tag/contact list entities) by ID(s) for the partner/broadcast module.

***

### Endpoint

* **Method:** `GET` *(unusual for a delete operation; documented as currently used in Postman)*

* **URL:** `https://business.me-mate.net/partners/broadcast/delete/taglist`

> Recommendation: For RESTful design, this operation is typically implemented as `DELETE` or `POST` (e.g., `/delete/taglist`) with a JSON body. However, this request is currently configured as **GET with a raw JSON body** in Postman—use it as-is if that’s what the server expects.

***

### Authentication & Required Headers

Include the following headers when calling this endpoint:

| Header             | Required | Value / Notes                                                  |
| ------------------ | -------- | -------------------------------------------------------------- |
| `X-Requested-With` | Yes      | `XMLHttpRequest`                                               |
| `Authorization`    | Yes      | `Bearer {{auth token}}` *(token stored as a Postman variable)* |

Notes:

* The collection/workspace currently uses a variable named `{{auth token}}`. Ensure it contains a valid partner session token.

***

### Request Body

Although the method is `GET`, this request uses a **raw JSON** body in Postman.

#### Schema

```json
{
  "ids": "string" 
}

```

#### `ids` format (important)

* `ids` is a **string** that itself contains a JSON array representation, e.g. `"[112995]"`.

* This is *not* an actual JSON array type in the payload; it is a string that looks like an array.

Examples:

* Single id: `"[112995]"`

* Multiple ids (if supported by backend): `"[112995,112996]"`

#### Example payload (as currently used)

```json
{
  "ids": "[112995]"
}

```

***

### Success Response

#### `200 OK`

Example body:

```json
{
  "status": true,
  "msg": "1 Contact List(s) Deleted Successfully!"
}

```

***

### Error Cases (plausible)

Exact error shapes may vary; these are common outcomes to handle.

* **401 Unauthorized** — Missing/expired token.
  * Example: `Authorization` header absent or invalid.

* **403 Forbidden** — Token is valid but lacks permission to delete lists.

* **422 Unprocessable Entity** — Validation error (e.g., `ids` missing, empty, wrong formatting, non-existent IDs).

* **500 Internal Server Error** — Unexpected backend failure.

***

### Postman Usage Checklist

1. Set/update the variable **`auth token`** (Global or Environment) with a valid token.

2. Confirm headers:
   * `X-Requested-With: XMLHttpRequest`

   * `Authorization: Bearer {{auth token}}`

3. In **Body → raw → JSON**, provide:

   ```json
   {"ids":"[112995]"}

   ```

4. Click **Send** and verify you receive `200` with `{"status":true,...}`.

Reference: https://apidocs.me-mate.net/business-me-mate-net-ap-is-document-v-1-0/manage-contact/contact-list-deletion/https-business-me-mate-net-partners-broadcast-delete-taglist

## Request

### Headers

- `X-Requested-With` (string, optional)

## Response

### 200

OK

- `msg` (string, required)
- `status` (boolean, required)

## Examples

**Request**

```json
{
  "ids": "[145672,145673]"
}
```

**Response**

```json
{
  "msg": "2 Contact List(s) Deleted Successfully!",
  "status": true
}
```

**SDK Code**

```python
import requests

url = "https://business.me-mate.net/partners/broadcast/delete/taglist"

payload = { "ids": "[145672,145673]" }
headers = {
    "X-Requested-With": "XMLHttpRequest",
    "Content-Type": "application/json"
}

response = requests.get(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = 'https://business.me-mate.net/partners/broadcast/delete/taglist';
const options = {
  method: 'GET',
  headers: {'X-Requested-With': 'XMLHttpRequest', 'Content-Type': 'application/json'},
  body: '{"ids":"[145672,145673]"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://business.me-mate.net/partners/broadcast/delete/taglist"

	payload := strings.NewReader("{\n  \"ids\": \"[145672,145673]\"\n}")

	req, _ := http.NewRequest("GET", url, payload)

	req.Header.Add("X-Requested-With", "XMLHttpRequest")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://business.me-mate.net/partners/broadcast/delete/taglist")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Requested-With"] = 'XMLHttpRequest'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ids\": \"[145672,145673]\"\n}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://business.me-mate.net/partners/broadcast/delete/taglist")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Content-Type", "application/json")
  .body("{\n  \"ids\": \"[145672,145673]\"\n}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://business.me-mate.net/partners/broadcast/delete/taglist', [
  'body' => '{
  "ids": "[145672,145673]"
}',
  'headers' => [
    'Content-Type' => 'application/json',
    'X-Requested-With' => 'XMLHttpRequest',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://business.me-mate.net/partners/broadcast/delete/taglist");
var request = new RestRequest(Method.GET);
request.AddHeader("X-Requested-With", "XMLHttpRequest");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"ids\": \"[145672,145673]\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "X-Requested-With": "XMLHttpRequest",
  "Content-Type": "application/json"
]
let parameters = ["ids": "[145672,145673]"] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://business.me-mate.net/partners/broadcast/delete/taglist")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```