Blacklist API

Block customers from making purchases based on email or IP address.

Endpoints Overview

Method	Endpoint	Description
`GET`	`/v1/blacklist`	List blacklist entries
`POST`	`/v1/blacklist`	Add to blacklist
`DELETE`	`/v1/blacklist`	Remove from blacklist

List Blacklist

GET /v1/blacklist

Query Parameters

Parameter	Type	Description
`page`	integer	Page number (default: 1)
`limit`	integer	Items per page (default: 25, max: 100)
`type`	string	Filter by type: `email` or `ip`

Response

{
  "data": [
    {
      "id": "bl_abc123",
      "type": "email",
      "value": "spammer@example.com",
      "email": "spammer@example.com",
      "ip_address": null,
      "reason": "Fraudulent orders",
      "created_at": "2025-01-15T10:00:00Z",
      "updated_at": "2025-01-15T10:00:00Z"
    },
    {
      "id": "bl_def456",
      "type": "ip",
      "value": "192.168.1.100",
      "email": null,
      "ip_address": "192.168.1.100",
      "reason": "Multiple chargebacks",
      "created_at": "2025-01-16T14:30:00Z",
      "updated_at": "2025-01-16T14:30:00Z"
    }
  ],
  "meta": {
    "total": 15,
    "limit": 25,
    "offset": 0
  }
}

Example Request

curl -X GET "https://api.sellgate.cc/v1/blacklist?type=email" \
  -H "Authorization: Bearer sg_live_your_api_key"

Add to Blacklist

POST /v1/blacklist

Request Body (Option 1 - Email)

{
  "email": "badactor@example.com",
  "reason": "Attempted fraud"
}

Request Body (Option 2 - IP)

{
  "ip_address": "192.168.1.100",
  "reason": "Multiple chargebacks"
}

Request Body (Option 3 - Type/Value format)

{
  "type": "email",
  "value": "badactor@example.com",
  "reason": "Attempted fraud"
}

Example Request

curl -X POST "https://api.sellgate.cc/v1/blacklist" \
  -H "Authorization: Bearer sg_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "badactor@example.com",
    "reason": "Attempted fraud"
  }'

Response (201 Created)

{
  "success": true,
  "id": "bl_new123",
  "type": "email",
  "value": "badactor@example.com"
}

If the entry already exists, it will be updated with the new reason instead of creating a duplicate.

Remove from Blacklist

DELETE /v1/blacklist

Query Parameters

Provide one of the following to identify the entry:

Parameter	Type	Description
`id`	string	Blacklist entry ID
`email`	string	Email to unblock
`ip_address`	string	IP address to unblock

Example Requests

# By ID
curl -X DELETE "https://api.sellgate.cc/v1/blacklist?id=bl_abc123" \
  -H "Authorization: Bearer sg_live_your_api_key"

# By email
curl -X DELETE "https://api.sellgate.cc/v1/blacklist?email=customer@example.com" \
  -H "Authorization: Bearer sg_live_your_api_key"

# By IP
curl -X DELETE "https://api.sellgate.cc/v1/blacklist?ip_address=192.168.1.100" \
  -H "Authorization: Bearer sg_live_your_api_key"

Response

{
  "success": true
}

Blacklist Types

Type	Description	Example
`email`	Block by email address	`spam@example.com`
`ip`	Block by IP address	`192.168.1.100`

Blacklist Object

Field	Type	Description
`id`	string	Entry identifier
`type`	string	`email` or `ip`
`value`	string	The blocked value
`email`	string	Email (if type is email)
`ip_address`	string	IP address (if type is ip)
`reason`	string	Reason for blocking
`created_at`	string	Creation timestamp
`updated_at`	string	Last update timestamp

Blacklist API

On this page