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.
https://app.replysparrow.com/api/v1/excluded_contactsAuthorizations
Query Parameters
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
Exact email address. Case-insensitive
Response
application/jsonList of excluded contacts with pagination information
Excluded contacts on this page, most recent first
Total number of excluded contacts matching the search
Current page number
Number of excluded contacts per page
Total number of pages
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}