GET jobs/all_scopes/get_next_status_sequence

Available from CRM.COM R13.0.0

This method returns the status to which an existing job can be updated to based on the job type's Status Sequence. Multiple statuses might be returned by each call 

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

job_identifier

(mandatory)

Job Type Identifier

The identifier of the job for which the next status in the allowed status sequence will be retrieved. The allowed job identifiers are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the job

number

(semi-optional)

String

The number of the job

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

NameType Description

id

String

The ID of the retrieved job type status

defaultBooleanDetermines if the job type status is the default status or not
statusJob Status ObjectThe actual status provided by the job type status

Referred Objects Response Data

 job_status object response data

Name

Type

Description

id

String

The ID of the retrieved job status

name

String

The name of the retrieved job status

alternative_code

String

The alternative code of the retrieved job status

descriptionStringA description of the retrieved job status
life_cycle_stateString

The life cycle state related with the retrieved job status

The supported life cycle states are the following: DRAFT, PENDING, IN_PROGRESS,COMPLETED,CANCELLED

Examples

 Example 1

HTTP Method: GET

 

Request:

Response:

 {
  "data": [
    {
      "default": true,
      "id": "C44D1791DD0B45CAB79C00201CB7C41B",
      "status": {
        "alternative_code": "2",
        "name": "Approved",
        "description": null,
        "id": "7A98FA9566534F1C82227985EA48F617",
        "life_cycle_state": "IN_PROGRESS"
      }
    },
    {
      "default": true,
      "id": "FF01B0A36BF04C129081DE1FD67FD3F0",
      "status": {
        "alternative_code": "C",
        "name": "Cancelled",
        "description": null,
        "id": "8B7D8C54FDC64DE592C5F170041DC91C",
        "life_cycle_state": "CANCELLED"
      }
    }
  ],
  "status": {
    "code": "OK",
    "description": "",
    "message": ""
  }
}