Get blocklist check status

GET

/api/v1/blacklist/status/{scan_uuid}

const url = 'https://app.hostrepute.com/api/v1/blacklist/status/01a178db-d833-70d2-8436-d39da22fcd8a';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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

curl --request GET \
  --url https://app.hostrepute.com/api/v1/blacklist/status/01a178db-d833-70d2-8436-d39da22fcd8a \
  --header 'Authorization: Bearer <token>'

Get the progress and, once it has ended, the result of a blocklist check. result is only present when status is completed or failed. A failed check means HostRepute couldn’t get answers from the blocklists, not that the domain or IP is listed.

Needs the blacklist:read ability.

Authorizations

bearer

Parameters

Path Parameters

scan_uuid

required

string

The UUID of the blocklist check, from the response of the start request.

Example

01a178db-d833-70d2-8436-d39da22fcd8a

Responses

200

application/json

object

data

object

uuid

string

host

string

status

string

is_completed

boolean

callback_status

string

nullable

data_source_count

integer

completed_source_count

integer

listed_data_source_count

integer

failed_data_source_count

integer

progress_percent

integer

error_message

string

nullable

result

object

host

string

data_sources

Array<object>

object

data_source_id

integer

data_source_name

string

data_source_host

string

source_status

string

is_listed

boolean

details

Array<object>

object

host

string

class

string

ttl

integer

type

string

error

string

nullable

listed_count

integer

total_count

integer

failed_count

integer

skipped_count

integer

is_listed

boolean

relisted_detected

boolean

data_source_group

object

uuid

string

name

string

slug

string

description

string

is_default

boolean

deliverability_checks_enabled

boolean

deliverability_checks

Array<string>

created_at

string

updated_at

string

started_at

string

completed_at

string

created_at

string

Example

{
  "data": {
    "uuid": "01a178db-d833-70d2-8436-d39da22fcd8a",
    "host": "example.net",
    "status": "completed",
    "is_completed": true,
    "callback_status": null,
    "data_source_count": 4,
    "completed_source_count": 4,
    "listed_data_source_count": 1,
    "failed_data_source_count": 0,
    "progress_percent": 100,
    "error_message": null,
    "result": {
      "host": "example.net",
      "data_sources": [
        {
          "data_source_id": 81,
          "data_source_name": "black.uribl.com",
          "data_source_host": "black.uribl.com",
          "source_status": "completed",
          "is_listed": true,
          "details": [
            {
              "host": "example.net.black.uribl.com",
              "class": "IN",
              "ttl": 300,
              "type": "A",
              "ip": "127.0.0.2"
            }
          ],
          "error": null
        },
        {
          "data_source_id": 82,
          "data_source_name": "dbl.nordspam.com",
          "data_source_host": "dbl.nordspam.com",
          "source_status": "completed",
          "is_listed": false,
          "details": [],
          "error": null
        },
        {
          "data_source_id": 87,
          "data_source_name": "grey.uribl.com",
          "data_source_host": "grey.uribl.com",
          "source_status": "completed",
          "is_listed": false,
          "details": [],
          "error": null
        },
        {
          "data_source_id": 89,
          "data_source_name": "multi.surbl.org",
          "data_source_host": "multi.surbl.org",
          "source_status": "completed",
          "is_listed": false,
          "details": [],
          "error": null
        }
      ],
      "listed_count": 1,
      "total_count": 4,
      "failed_count": 0,
      "skipped_count": 0,
      "is_listed": true,
      "relisted_detected": false
    },
    "data_source_group": {
      "uuid": "01a178db-d581-700d-9729-4f4abc8cee72",
      "name": "Default",
      "slug": "default",
      "description": "All production domains",
      "is_default": true,
      "deliverability_checks_enabled": true,
      "deliverability_checks": [
        "mx_health",
        "spf_record",
        "spf_strict",
        "spf_lookup_limit",
        "dmarc_record",
        "dmarc_strict"
      ],
      "created_at": "2026-07-14T09:12:44.000000Z",
      "updated_at": "2026-09-02T14:05:31.000000Z"
    },
    "started_at": "2026-10-26T15:37:16.000000Z",
    "completed_at": "2026-10-26T15:37:31.000000Z",
    "created_at": "2026-10-26T15:37:16.000000Z"
  }
}

404

No blocklist check with this UUID in your team

application/json

object

message

string

Example

{
  "message": "No query results for model [App\\Models\\BlacklistScan] 01a178db-d833-70d2-8436-d39da22fcd8a"
}