4.3 Get Leads from ReactIn via API

✅ What you’ll need before you start

Before using this API, make sure you have:

1. A ReactIn API SmartList

2. Your Organization ID, List ID, and API Key

📘 👉 Not sure how to get these? Follow this guide

🔗 API Endpoint

Send a GET request to this endpoint to get a lead:

GET https://app.reactin.io/api/[organizationId]/lists/[listId]/leads

This will return a paginated list of enriched leads in your SmartList.

🔐 Authentication & Headers

You need to send your API key in the headers using a Bearer token.

🔐 Your API key is visible when you create a ReactIn API SmartList or in the settings. Never expose it in public code.

📄 Query Parameters

Each page contains up to 50 leads.

🧪 Example (JavaScript)

const fetchLeads = async (organizationId, listId, page = 1) => {
  try {
    const response = await fetch(
      `https://app.reactin.io/api/v1/${organizationId}/lists/${listId}/leads?page=${page}&pageSize=${pageSize}`,
      {
        method: 'GET',
        headers: {
          'Authorization': 'YOUR_API_KEY',
          'Content-Type': 'application/json'
        }
      }
    );

    if (!response.ok) {
      throw new Error(`HTTP Error: ${response.status}`);
    }

    const data = await response.json();

    console.log('Leads:', data.data);
    console.log('Page:', data.page);
    console.log('Next Page:', data.nextPage);

    return data;
  } catch (error) {
    console.error('Error fetching leads:', error);
  }
};

🧾 Response format

{
  "data": [
    {
      "First Name": "John",
      "Last Name": "Doe",
      "Email": "john.doe@example.com",
      "Profile": "https://www.linkedin.com/in/johndoe/",
      "My AI Column": "Generated insight"
    }
  ],
  "page": 1,
  "nextPage": 2
}

• data: the list of leads

• page: current page number

• nextPage: the next page number (or null if done)

✅ Success Response

• 200 OK – Leads fetched successfully

🚫 Common Errors

💡 Best Practices

• ⚡ Use pagination to avoid overloading your app

• 📥 Cache results when possible to reduce API calls

• 🔐 Keep your API key private — use a backend server or proxy

• 🔁 Add retry logic for occasional network or server errors

💡 Pro tip: Cache API responses on your end to optimize performance and reduce unnecessary calls.

Ready to move on?
👉 Next Step: Connect External Tools to Push Leads into ReactIn →