ReplySparrow Docs

Excluded Contacts

Get all excluded contacts with pagination and search

Excluded contacts are people your agents must never import again. A contact is excluded when it is deleted (with DELETE /api/v1/contacts/{id}) or added to the blocklist in the app: its LinkedIn profile URL and email, when known, are kept in your excluded contacts, one exclusion each. The lead source agents skip any lead matching one of them, nobody is messaged at an excluded profile or address, and POST /api/v1/contacts refuses to create it again (409 contact_already_excluded). Needs the contacts:read scope.

Use this route to find the exclusion of a person, then DELETE /api/v1/excluded_contacts/{id} to allow it to be imported again. Results are sorted from the most recent exclusion to the oldest. Company (domain) blocks are not listed here.

gethttps://app.replysparrow.com/api/v1/excluded_contacts

Authorizations

Authorizationstringheaderrequired

Your API key from Settings → API, sent as Bearer <token>.

Query Parameters

pagenumber

Page number, starting at 1

Default: 1

limitnumber

Items per page (1-100, default 20)

Default: 20

LinkedIn public identifier of the person (eg. johndoe), or their full LinkedIn profile URL (eg. https://www.linkedin.com/in/johndoe). Matches exclusions with this LinkedIn profile URL. Case-insensitive

emailstring

Exact email address. Case-insensitive

Response

application/json

List of excluded contacts with pagination information

excluded_contactsobject[]required

Excluded contacts on this page, most recent first

totalnumberrequired

Total number of excluded contacts matching the search

pagenumberrequired

Current page number

limitnumberrequired

Number of excluded contacts per page

totalPagesnumberrequired

Total number of pages

Get all excluded contacts with pagination and search
curl --request GET \  --url https://app.replysparrow.com/api/v1/excluded_contacts \  --header 'Authorization: Bearer <token>'
{  "excluded_contacts": [    {      "id": "0192c4a1-7d2e-7f3a-9b10-5e6f7a8b9c0d",      "kind": "linkedin",      "value": "linkedin.com/in/johndoe",      "profile_url": "https://www.linkedin.com/in/johndoe",      "email": null,      "name": null,      "reason": "Contact deleted",      "source": "contact_deleted",      "created_at": "2026-10-24T09:12:44.000Z"    }  ],  "total": 1,  "page": 1,  "limit": 20,  "totalPages": 1}