GET / blacklist-contacts/import/list

Base URL: https://backend.easify.app/api/v3

This endpoint is used to retrieve blacklist import history.

There is a rate limit of 60 requests per minute. If you exceed this limit, you will receive a 429 Too Many Requests status, along with a message indicating when you can try again.

Authentication

The Easify API token used for authentication is passed in the header as a Bearer token, which can be obtained from the Easify app under Settings > API Settings.

Headers

Authorization string required Bearer << YOUR_EASIFY_API_TOKEN_HERE >>

Query Parameters

limit integer Pagination for the list
Default: 10
Minimum: 1, Maximum: 50 		Optional
page integer The page number for paginated data
Default: 1 		Optional

Sample Params and Response:

params

{
  "page": 2,
  "limit": 10
}

Success Response:

{
  "status": true,
  "message": "Blacklist contact import history",
  "data": [
    {
      "id": 98,
      "file_name": "blacklist_import_10000.csv",
      "status": "In Progress",
      "progress_percentage": 0,
      "total_count": 10000,
      "skipped_count": 0,
      "stored_count": 0,
      "created_at": "07-22-2025 05:36:33 AM"
    },
    {
      "id": 89,
      "file_name": "blacklist_import.csv",
      "status": "Completed",
      "progress_percentage": 0,
      "total_count": 2,
      "skipped_count": 0,
      "stored_count": 2,
      "created_at": "07-22-2025 02:18:40 AM"
    },
    {
      "id": 89,
      "file_name": "skipped_numbers.csv",
      "status": "Failed",
      "progress_percentage": 0,
      "total_count": 10,
      "skipped_count": 0,
      "stored_count": 2,
      "created_at": "07-22-2025 02:18:40 AM"
    }
  ],
  "links": {
    "self": "link-value",
    "first": "https://backend.easify.app/api/v3/blacklist-contacts/import/list?limit=10&page=1",
    "last": "https://backend.easify.app/api/v3/blacklist-contacts/import/list?limit=10&page=2",
    "prev": null,
    "next": "https://backend.easify.app/api/v3/blacklist-contacts/import/list?limit=10&page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 2,
    "links": [
      {
        "url": null,
        "label": "« Previous",
        "active": false
      },
      {
        "url": "https://backend.easify.app/api/v3/blacklist-contacts/import/list?limit=10&page=1",
        "label": "1",
        "active": true
      },
      {
        "url": "https://backend.easify.app/api/v3/blacklist-contacts/import/list?limit=10&page=2",
        "label": "2",
        "active": false
      },
      {
        "url": "https://backend.easify.app/api/v3/blacklist-contacts/import/list?limit=10&page=2",
        "label": "Next »",
        "active": false
      }
    ],
    "path": "https://backend.easify.app/api/v3/blacklist-contacts/import/list",
    "per_page": 10,
    "to": 10,
    "total": 13
  }
}

Api Response Status

Case Status Code Response
If the user does not provide a token in the header or provides an invalid token 401 { "status":false, "message": "Unauthenticated", "errors": [] }
If the user exceeds the allowed rate limit for requests 429 { "status":false, "message":"Too many requests. Try again in 59 seconds", "errors":[] }
If the user's subscription has ended 402 { "status":false,"message":"You need to recharge your account to proceed","errors":[] }
If the user does not have an enterprise plan 403 { "status": false, "message": "Access denied. Your current plan does not allow access to this feature. Please upgrade to the Enterprise plan.", "errors": [] }
If the limit exceeds maximum value 422 { "message": "The limit field must not be greater than 50.", "errors": { "limit": [ "The limit field must not be greater than 50." ] } }
If the limit is less than minimum value 422 { "message": "The limit field must be at least 1.", "errors": { "limit": [ "The limit field must be at least 1." ] } }

PHP-cURL

php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://backend.easify.app/api/v3/blacklist-contacts/import/list?limit=10',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Accept: application/json',
    'Authorization: Bearer '
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
pixel for linkedin