- Overview
- What's New in V8?
- Changelog
- Open API Specification 3.0.0 (OAS)
- API Directory
- API Collection
- APIs and References
- OAuth
- API Limits and Credits
- Compliance
- Zoho CRM SDKs
- Metadata APIs
- Customization
- Process Automation
- Security control
- Roles
- Profiles
- Territories
- GETTerritories
- POSTTerritories
- PUTTerritories
- DELETETerritories
- POSTTransfer and Delete Territories
- GETChild Territories of a Territory
- GETTerritories Assigned
- GETAssociated User Count
- GETRetrieve User details Associated with a Territory
- PUTAssociate Users with Territory
- POSTRemove Territories of Records
- POSTAssign Territories to Records
- DELETEDisassociate Users from Territory
- Export Audit Log
- Portals
- Data Sharing
- Company Settings
- Zia
- Core APIs
- Records
- Merge Records
- Share Records
- Mail Merge
- Services
- Appointments
- Appointments Rescheduled History
- Fields Attachments
- Meeting Cancel
- Notes
- Mass Actions
- Related Records
- External ID
- Emails
- Subforms
- Linking Modules
- Others
- Bulk APIs
- Composite API
- Query API
- Notification APIs
Mass Convert Lead Status
Purpose
To get the status of the mass convert lead job scheduled previously.
Endpoints
- GET /Leads/actions/mass_convert?job_id={job_id}
Request Details
Request URL
{api-domain}/Leads/actions/mass_convert?job_id={job_id}
Header
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Scope
scope=ZohoCRM.mass_convert.leads.READ
Sample Request
Copiedcurl "https://www.zohoapis.com/crm/v8/Leads/actions/mass_convert?job_id= 3652397000009835020"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"Response JSON Keys
- Statusstring
Indicates the status of the mass convert lead API. Possible values are "completed", "scheduled", and "in progress", and "failed".
- Total_Countinteger
Specifies the total number of leads that were scheduled to be converted.
- Converted_Countinteger
Specifies the number of leads that were converted.
- Not_Converted_Countinteger
Specifies the number of leads that are yet to be converted.
- Failed_Countinteger
Specifies the number of leads that were not converted.
Possible Errors
- REQUIRED_PARAM_MISSINGHTTP 400
You have not specified the job_id in the request.
Resolution: The specified job_id is not found or invalid. Specify a valid job_id. - INVALID_DATAHTTP 400
The job_id is invalid.
Resolution: Specify a valid job ID.
Sample Response
Copied{
"data": [
{
"Status": "COMPLETED",
"Failed_Count": 0,
"Not_Converted_Count": 0,
"Total_Count": 28,
"Converted_Count": 28
}
]
}© 2025, Zoho Corporation Pvt. Ltd. All Rights Reserved.