Get lead
curl --request GET \
--url https://{your-subdomain}.neetocrm.com/api/external/v1/leads/{id} \
--header 'X-Api-Key: <x-api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};
fetch('https://{your-subdomain}.neetocrm.com/api/external/v1/leads/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetocrm.com/api/external/v1/leads/{id}"
headers = {"X-Api-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"lead": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Eve",
"status": "open",
"unique_number": "L-001",
"email": "eve@example.com",
"phone_number": "",
"contact": {
"id": null,
"name": "Eve"
},
"company": {
"id": null,
"name": null
},
"owner": null,
"tags": [],
"created_at": "2025-03-15T10:30:00.000Z",
"updated_at": "2025-03-15T10:30:00.000Z"
}
}API v1 (Deprecated)
Get lead
Retrieve a single lead by its ID.
GET
/
leads
/
{id}
Get lead
curl --request GET \
--url https://{your-subdomain}.neetocrm.com/api/external/v1/leads/{id} \
--header 'X-Api-Key: <x-api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};
fetch('https://{your-subdomain}.neetocrm.com/api/external/v1/leads/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetocrm.com/api/external/v1/leads/{id}"
headers = {"X-Api-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"lead": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Eve",
"status": "open",
"unique_number": "L-001",
"email": "eve@example.com",
"phone_number": "",
"contact": {
"id": null,
"name": "Eve"
},
"company": {
"id": null,
"name": null
},
"owner": null,
"tags": [],
"created_at": "2025-03-15T10:30:00.000Z",
"updated_at": "2025-03-15T10:30:00.000Z"
}
}Deprecated: This is a v1 endpoint. It will continue to work, but we recommend migrating to
the v2 equivalent for improved REST compliance (correct HTTP status codes,
consistent response envelopes, and hyphenated URLs).
Replace
Learn how to find your subdomain in Workspace subdomain.
{your-subdomain} with your workspace’s subdomain. Learn how to find your subdomain in Workspace subdomain.
Headers
Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.
Path Parameters
The ID of the lead to retrieve. You can get the lead id by listing all leads using our List all leads API.
Response
200 - application/json
Successfully retrieved the lead.
Hide child attributes
Hide child attributes
Unique identifier for the lead.
Name of the lead.
Current status of the lead.
Available options:
open, converted, archived Auto-generated unique number for the lead.
Email address of the lead (from associated contact).
Phone number of the lead (from associated contact).
Owner of the lead.
Timestamp when the lead was created.
Timestamp when the lead was last updated.
⌘I