GET leads/configuration/lost_reasons/list

Available from CRM.COM R9.0.0

This method returns the lost reasons that are allowed to be used by leads of any type. All Lost Reasons defined in the active Lead Definitions are retrieved if no type is defined. Multiple lost reasons are returned by each call

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

lead_type_identifier

(optional)

Lead Type Identifier

The identifier of the type of the lead that will be using the lost reasons. The lost reasons are filtered against the allowed lost reasons of the specified type. The allowed lead type identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the lead type

name

(semi-optional)

String

The name of the lead type

alternative_code

(semi-optional)

String

The alternative code of lead type

Available from CRM.COM R14.0.0

fields_set

(optional)

List of Strings, comma separated

A list of fields that should be included in the results. If not specified then all the available fields will be returned

Response Data

Name	Type	Description
id	String	The ID of the retrieved lead lost reason
name	String	The name of the retrieved lead lost reason
alternative_code	String	The alternative code of the retrieved lead lost reason
description	String	The description of the retrieved lead lost reason

Examples

Example 1

HTTP Method: GET

Request:

Response:

 {
       "id": "2CCA640BAB9C49B2B057380380809BAA",
       "name": "No Requirements Mapping",
       "alternative_code": "NRM"
   },
   {
       "id": "F0FE0C78A9FE4BB9BDD1B1DACF6D910C",
       "name": "Not Interested",
       "alternative_code": "NI"
   },
   {
       "id": "0D41B1B5E3B4498E87E74051BD7D7711",
       "name": "Competitor",
       "alternative_code": "C_1"
   }

Example 2

HTTP Method: GET

Request:

Response:

 {
    "data": [
        {
            "alternative_code": "C",
            "name": "Competitors",
            "description": null,
            "id": "D4CB03A3D05A457AAC0854FFFAB0D20E"
        },
        {
            "alternative_code": "NI",
            "name": "Not Interested",
            "description": null,
            "id": "5ED5BBE85BE348D1B4F36235FBE55EA7"
        },
        {
            "alternative_code": "NI_1",
            "name": "Invalid Data",
            "description": null,
            "id": "00D3A96B7D5C436C9F4854C66BD9C5F9"
        },
        {
            "alternative_code": "C_1",
            "name": "Cost",
            "description": null,
            "id": "654D1D8B8CA8401FA818DD7A44B99BFF"
        }
    ],
    "status": {
        "code": "OK",
        "description": "",
        "message": ""
    }
}