Docs home

Get Leads List

Lists the leads (enquiries) of your institute for one organization, newest lead first, with their latest and next follow-up. Use it to copy leads into a CRM or to build a follow-up queue.

GET/contactus
Get Leads List
curl --request GET \
  --url 'https://<your-api-host>/nuSource/api/v1/contactus?organization_id=<organizationId>&page=1&status=1&followup_status=0' \
  --header 'APIKEY: <your-api-key>' \
  --header 'ORGID: <your-org-id>'
{
    "code": 200,
    "message": "Success",
    "enquiries": [
        {
            "lead_id": 45072,
            "first_name": "test10",
            "email": "",
            "message": "",
            "date": "22/12/2021",
            "time": "11:20 AM",
            "formatted_date": "22nd Dec 2021",
            "last_name": "",
            "country": "",
            "contact_number": "7893639750",
            "source": 66,
            "status": 1,
            "org_id": 212,
            "lead_date": 4294967295,
            "followup_comment": "fhhhj",
            "followup_date": 1663929600,
            "followup_count": 4,
            "next_followup_id": 20696,
            "next_followup_date": 1659953400,
            "next_followup_comment": "",
            "followup_id": 20963,
            "owner_id": 404,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 53409,
            "first_name": "maa",
            "email": "",
            "message": "",
            "date": "09/08/2019",
            "time": "02:42 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "0771885110",
            "source": 70,
            "status": 1,
            "org_id": 212,
            "lead_date": 4294967295,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 1,
            "next_followup_id": 21075,
            "next_followup_date": 1667479200,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 201,
            "contact_number_country_id": 1,
            "contact_number_dial_code": "+93"
        },
        {
            "lead_id": 53415,
            "first_name": "sampreeth",
            "email": "",
            "message": "",
            "date": "09/08/2019",
            "time": "02:39 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "9898989866",
            "source": 66,
            "status": 1,
            "org_id": 212,
            "lead_date": 4294967295,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 200,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 60779,
            "first_name": "Harshit Sharaff",
            "email": "harshit@edmingle.com",
            "message": "I want to join JEE",
            "date": "09/08/2019",
            "time": "02:39 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "8878656747",
            "source": 321,
            "status": 1,
            "org_id": 212,
            "lead_date": 1682413442,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 200,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 60319,
            "first_name": "Harshit Sharaff",
            "email": "harshit@edmingle.com",
            "message": "I want to join JEE",
            "date": "09/08/2019",
            "time": "02:39 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "8878656747",
            "source": 321,
            "status": 1,
            "org_id": 212,
            "lead_date": 1682056048,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 200,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 60318,
            "first_name": "Harshit Sharaff",
            "email": "harshit@edmingle.com",
            "message": "I want to join JEE",
            "date": "09/08/2019",
            "time": "02:42 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "8878656747",
            "source": 321,
            "status": 1,
            "org_id": 212,
            "lead_date": 1682056021,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 201,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 55475,
            "first_name": "Test",
            "email": "testedmingle@edmingle.com",
            "message": "Ahjvdshjavsdhvd",
            "date": "01/01/1970",
            "time": "05:30 AM",
            "formatted_date": "1st Jan 1970",
            "last_name": "nIkhil",
            "country": "",
            "contact_number": "9439545425",
            "source": 1,
            "status": 1,
            "org_id": 212,
            "lead_date": 1673432919,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 0,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 55474,
            "first_name": "megh",
            "email": "megh@edmingle.com",
            "message": "l",
            "date": "01/01/1970",
            "time": "05:30 AM",
            "formatted_date": "1st Jan 1970",
            "last_name": "megh",
            "country": "",
            "contact_number": "9988090909",
            "source": 1,
            "status": 1,
            "org_id": 212,
            "lead_date": 1673432573,
            "followup_comment": "",
            "followup_date": 1673433900,
            "followup_count": 3,
            "next_followup_id": 21208,
            "next_followup_date": 1673520300,
            "next_followup_comment": "",
            "followup_id": 21207,
            "owner_id": 0,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 53410,
            "first_name": "saaaaaaaa",
            "email": "",
            "message": "Saaa is the The history of Afghanistan as a state began in 1823 as the Emirate of Afghanistan after the ... Soldiers of God: With Islamic Warriors in Afghanistan and Pakistan, ...",
            "date": "09/08/2019",
            "time": "02:42 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "8888888888",
            "source": 67,
            "status": 1,
            "org_id": 212,
            "lead_date": 1667327400,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 201,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 53411,
            "first_name": "miiii",
            "email": "",
            "message": "",
            "date": "09/08/2019",
            "time": "02:42 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "9999999999",
            "source": 66,
            "status": 1,
            "org_id": 212,
            "lead_date": 1667327400,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 201,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 53412,
            "first_name": "miii",
            "email": "",
            "message": "",
            "date": "09/08/2019",
            "time": "02:39 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "7575757575",
            "source": 66,
            "status": 1,
            "org_id": 212,
            "lead_date": 1667327400,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 200,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 53414,
            "first_name": "samarth",
            "email": "",
            "message": "",
            "date": "09/08/2019",
            "time": "02:39 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "8686868686",
            "source": 66,
            "status": 1,
            "org_id": 212,
            "lead_date": 1667327400,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 200,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 53418,
            "first_name": "RR",
            "email": "",
            "message": "student details are as follows student details are as followsv student details are as followsvstudent details are as followsstudent details are as follows student details are as followsstudent details are as followsstudent details are as followsstudent details are as followsstudent details are as followsstudent details are as followsstudent details are as followsstudent details are as followsstudent details are as followsstudent details are as followsvstudent details are as followsstudent details are as fol",
            "date": "09/08/2019",
            "time": "02:39 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "9888888888",
            "source": 66,
            "status": 1,
            "org_id": 212,
            "lead_date": 1667327400,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 200,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 50914,
            "first_name": "MK test",
            "email": "",
            "message": "",
            "date": "22/12/2021",
            "time": "11:20 AM",
            "formatted_date": "22nd Dec 2021",
            "last_name": "",
            "country": "",
            "contact_number": "7890983903",
            "source": 378,
            "status": 1,
            "org_id": 212,
            "lead_date": 1659465000,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 404,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 50437,
            "first_name": "suman",
            "email": "suman@s.s",
            "message": "hjd",
            "date": "01/01/1970",
            "time": "05:30 AM",
            "formatted_date": "1st Jan 1970",
            "last_name": "",
            "country": "",
            "contact_number": "9879969340",
            "source": 1,
            "status": 1,
            "org_id": 212,
            "lead_date": 1657692258,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 0,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 50436,
            "first_name": "test234",
            "email": "test234@test.com",
            "message": "test234 test234 test234 test234",
            "date": "01/01/1970",
            "time": "05:30 AM",
            "formatted_date": "1st Jan 1970",
            "last_name": "",
            "country": "",
            "contact_number": "7854754120",
            "source": 1,
            "status": 1,
            "org_id": 212,
            "lead_date": 1657691522,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 0,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 50260,
            "first_name": "miko",
            "email": "ksk@hdn.co",
            "message": "hey",
            "date": "01/01/1970",
            "time": "05:30 AM",
            "formatted_date": "1st Jan 1970",
            "last_name": "",
            "country": "",
            "contact_number": "9879879987",
            "source": 1,
            "status": 1,
            "org_id": 212,
            "lead_date": 1656954529,
            "followup_comment": "",
            "followup_date": 1658418900,
            "followup_count": 1,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": 20548,
            "owner_id": 0,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 50253,
            "first_name": "miko",
            "email": "ksk@hdn.co",
            "message": "hey",
            "date": "01/01/1970",
            "time": "05:30 AM",
            "formatted_date": "1st Jan 1970",
            "last_name": "",
            "country": "",
            "contact_number": "9879879987",
            "source": 1,
            "status": 1,
            "org_id": 212,
            "lead_date": 1656928166,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 0,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 50229,
            "first_name": "mis",
            "email": "dndh@hd.co",
            "message": "nfj",
            "date": "09/08/2019",
            "time": "02:42 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "9877898788",
            "source": 66,
            "status": 1,
            "org_id": 212,
            "lead_date": 1656873000,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 201,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 50198,
            "first_name": "hio",
            "email": "jio@gmail.com",
            "message": "hry",
            "date": "09/08/2019",
            "time": "02:42 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "9879887689",
            "source": 66,
            "status": 1,
            "org_id": 212,
            "lead_date": 1656700200,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 201,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 50169,
            "first_name": "Harshit Sharaff",
            "email": "harshit@edmingle.com",
            "message": "I want to join JEE",
            "date": "22/12/2021",
            "time": "11:20 AM",
            "formatted_date": "22nd Dec 2021",
            "last_name": "",
            "country": "",
            "contact_number": "8878656747",
            "source": 67,
            "status": 1,
            "org_id": 212,
            "lead_date": 1656594896,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 404,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 50066,
            "first_name": "mcn",
            "email": "mcn@nfm.com",
            "message": "test",
            "date": "09/08/2019",
            "time": "02:39 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "9878987890",
            "source": 321,
            "status": 1,
            "org_id": 212,
            "lead_date": 1656095400,
            "followup_comment": "",
            "followup_date": 0,
            "followup_count": 0,
            "next_followup_id": 0,
            "next_followup_date": 0,
            "next_followup_comment": "",
            "followup_id": null,
            "owner_id": 200,
            "contact_number_country_id": 103,
            "contact_number_dial_code": "+91"
        },
        {
            "lead_id": 48562,
            "first_name": "Test Hardik",
            "email": "hardiaak@gmail.com",
            "message": "Testtttt",
            "date": "09/08/2019",
            "time": "02:42 PM",
            "formatted_date": "9th Aug 2019",
            "last_name": "",
            "country": "",
            "contact_number": "9666545525",
            "source": 321,
            "status": 1,
            "org_id": 212,
            "lead_d

Access: Institute admins, plus custom roles that can manage leads and enquiries. If you are set up as a lead owner, you only see leads assigned to you.

Query parameters
Organization (branch) whose leads to list. Defaults to your ORGID organization.
pageinteger
Page number, starting at 1. Default 1.
per_pageinteger
Results per page. Default 50.
statusinteger
Only leads with this lead status.
sourceinteger
Only leads from this source, for example 1 Website, 2 JustDial.
owner_idinteger
Only leads assigned to this owner.
startUnix timestamp
With end: only leads dated in this range.
endUnix timestamp
See start.
Only leads with a follow-up in this state: 1 Pending, 2 Done, 3 Cancelled.
followup_startUnix timestamp
With followup_end: only leads with a follow-up dated in this range.
followup_endUnix timestamp
See followup_start.

Response: enquiries is the list of leads. Each has lead_id, first_name, last_name, email, contact_number, contact_number_country_id, contact_number_dial_code, country, message, source, status, org_id, owner_id, lead_date and created_at (Unix timestamps), followup_count, the last completed follow-up (followup_id, followup_date, followup_comment) and the next pending one (next_followup_id, next_followup_date, next_followup_comment; 0/empty if none). count is the total number of matching leads.

Notes: Rate limit: 1000 requests per minute; going over locks you out for 30 minutes.

Updated yesterday

Ask AI