---
title: "Return Greylisting deferred incoming email triplets"
method: GET
path: "/read_cpgreylist_deferred_entries"
tags: ["Greylisting", "Spam Protection (Greylisting)"]
---

# Return Greylisting deferred incoming email triplets

`GET /read_cpgreylist_deferred_entries`

This function lists Greylisting's deferred triplets.
Greylisting identifies incoming email by triplets.

A triplet is a collection of three pieces of data:
* the IP address
* the sender's address
* the recipient's address

## Response `200`

HTTP Request was successful.

- object
  - `data` object
    - `greylist_deferred_entries` object[] — An object of deferred triplet data.
      - `accepted_count` integer — The number of times that Greylisting accepted the triplet.
      - `block_exp_time` string, ISO-8601 Date Time (Space Separated) — The date and time when Greylisting will no longer defer the triplet.
      - `create_time` string, ISO-8601 Date Time (Space Separated) — The date and time when Greylisting created the triplet.
      - `deferred_count` integer — The number of times Greylisting deferred the triplet.
      - `from_addr` string, email — The email address that the system identified as the triplet's sender.
      - `id` integer — The identification number that the system assigned to the triplet.
      - `must_retry_by` string, ISO-8601 Date Time (Space Separated) — The date and time when Greylisting will no longer accept the resent triplet.
      - `record_exp_time` string, ISO-8601 Date Time (Space Separated) — The date and time when Greylisting will purge the triplet from the database.
      - `sender_ip` string, ipv4 — The IP address that the system identified as the triplet's sender.
      - `to_addr` string, email — The email address that the system identified as the triplet's recipient.
    - `limit` integer — The number of triplets in the interface.
    - `offset` integer — The number of triplets to skip from the beginning of the query in the interface.
    - `server_timezone` string — The standard letter code abbreviation for the time zone.
    - `server_tzoffset` integer — The time zone offset in minutes.
    - `total_rows` integer — The total number of triplets in the database.
  - `metadata` object
    - `command` string — The method name called.
    - `reason` string — The reason the API function failed when the `metadata.result` field is `0`. This field may display a success message when a function succeeds.
    - `result` 0 | 1 — * `1` - Success * `0` - Failed: Check the reason field for more details.
    - `version` integer — The version of the API function.

---

[API](https://skmtc.net/cpanel/apis/whm-api.md) · [All operations](https://skmtc.net/cpanel/apis/whm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/whm-api/revisions/3da41671c02c/schema)