Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Blocked Spam Sources

List blocked spam sources

Lists the IP addresses, CIDR ranges, email addresses, and email domains the organization has blocked from submitting applications. Entries are managed under Configure > Real Talent > Spam in the Greenhouse UI and via this resource; applications arriving from a matching source are auto-rejected at intake with the reason Rejected by organization blocklist. Requires the Real Talent spam blocklist product flag to be enabled on the organization; without it the endpoint returns 403.

get/v3/blocked_spam_sources

Query parameters

cursorstring

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

per_pageinteger

Number of results per page

idsinteger[]

Comma separated list

gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
fieldsstring[]

Comma separated list of fields to return

source_type'ip_address' | 'cidr_block' | 'email_address' | 'email_domain'

Return only blocked spam sources of this kind. ip_address and cidr_block cover network-level blocks; email_address and email_domain cover sender-level blocks.

valuestring

Return only the blocked spam source whose value matches exactly. Matching is case-insensitive and ignores surrounding whitespace (values are stored normalized). For an exact match across all kinds, omit source_type; combine with source_type to disambiguate when the same string could appear under more than one kind.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
source_type'ip_address' | 'cidr_block' | 'email_address' | 'email_domain'

Kind of identifier stored in value. ip_address is a single IPv4 or IPv6 address, cidr_block is an IPv4 or IPv6 CIDR range, email_address is a full address, and email_domain is the part after the @. Applications arriving from a matching source are rejected at intake with the reason Rejected by organization blocklist.

valuestring

The IP address, CIDR range, email address, or email domain to block, interpreted according to source_type. Stored lowercased and stripped of surrounding whitespace, so filtering by value is case-insensitive. Common consumer email domains (e.g. gmail.com, outlook.com, yahoo.com) cannot be blocked and are rejected on create.

notestring nullable

Free-text annotation set by the user who added or last updated the entry, typically used to record why the source was blocked. Limited to 255 characters; null when no note was provided.