Skip to main content
GET
List DNC entries

Overview

Retrieve a paginated list of all Do Not Contact (DNC) entries for your team. This endpoint returns LinkedIn URLs that have been added to your DNC list, preventing them from being contacted in any campaigns.

Use Cases

  • Compliance Management: Maintain a comprehensive list of contacts who have opted out
  • Data Export: Export your DNC list for record-keeping or external systems
  • Audit Trail: Review all blocked contacts across your organization
  • Integration: Sync DNC data with external CRM or compliance systems
  • Monitoring: Track the size and growth of your DNC list over time

Key Features

  • Pagination Support: Efficiently retrieve large DNC lists with limit and offset parameters
  • Rate Limited: 60 requests per minute for optimal performance
  • Team Isolation: Only see DNC entries belonging to your team
  • Sorted by Date: Returns most recent entries first (descending order)
  • Complete Data: Includes all entry details including creation timestamps

Testing Example

Query Parameters

Response Format

Success Response (200 OK)

Error Responses

429 Too Many Requests - Rate Limit Exceeded

401 Unauthorized - Invalid API Key

500 Internal Server Error

Pagination

This endpoint supports pagination to handle large DNC lists efficiently:

Pagination Strategy

  1. First Page: GET /v1/dnc?limit=50&offset=0
  2. Second Page: GET /v1/dnc?limit=50&offset=50
  3. Third Page: GET /v1/dnc?limit=50&offset=100

Calculating Total Pages

Pagination Example

Rate Limiting

  • Limit: 60 requests per minute per team
  • Window: Rolling 60-second window
  • Headers: Rate limit information included in response headers
  • Exceeded: Returns 429 status with resetTime timestamp

Rate Limit Best Practices

  1. Implement Backoff: Wait for resetTime before retrying
  2. Cache Results: Store DNC list locally to reduce API calls
  3. Batch Operations: Use pagination efficiently to minimize requests
  4. Monitor Usage: Track your request count to avoid hitting limits

Integration Examples

Export to CSV

Sync with External CRM

Monitor DNC List Size

Response Data Structure

Important Note: The total field returns the number of entries in the current response (same as entries.length), NOT the total count of all DNC entries across all pages. To get the full count, you need to paginate through all results.

Entry Object Structure

Best Practices

  1. Use Pagination: Don’t fetch all entries at once; use limit/offset for large lists
  2. Cache Locally: Store DNC list locally and refresh periodically
  3. Rate Limit Awareness: Implement exponential backoff for 429 responses
  4. Error Handling: Always check for error field in response
  5. Audit Trail: Maintain local logs of DNC list state for compliance
  6. Regular Sync: Sync DNC list with external systems periodically
  7. Monitor Growth: Track DNC list size over time for compliance reporting

Performance Considerations

  • Database Indexed: Queries are optimized with composite index on teamId
  • Response Time: Typically < 200ms for lists under 1000 entries
  • Sorted Results: Entries returned in descending order by creation date
  • Team Isolation: Permissions enforced at database level for security

Common Use Cases

Daily Export for Compliance

Real-time Dashboard

Next Steps

After listing DNC entries:
  1. Check Specific URLs: Use Check DNC endpoint
  2. Add New Entries: Use Add Single or Bulk Add endpoints
  3. Remove Entries: Use Delete DNC endpoint
  4. Export Data: Integrate with external systems using the list data

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:50

Number of entries to return (1-1000)

Required range: 1 <= x <= 1000
offset
integer
default:0

Number of entries to skip for pagination

Required range: x >= 0

Response

List of DNC entries

error
null
data
object
Last modified on November 18, 2025