Orders / Statuses

Get Order Status

This endpoint retrieves data of a specific Order Status based on JSON input. The API returns a single Status available to the user in the Value List, according to the unique ID provided. If the specified Order Status does not exist, the response will be a "bad request".

You will only receive the Order Status after first providing the Session Key. To know how you can obtain the Session Key, go to Authentication.

HEADERS

ParameterValueDescription
Content-Typeapplication/jsonLanguage in which all request and response bodies are encoded
Accept*/*Any data of whatever mime type is accepted
X-Session-KeyAUTH_TOKENThis field must be completed with the token obtained at the authentication

REQUEST

ParameterTypeDescription
idIntegerThe unique and specific identifier of the Order Status

RESPONSE

AttributeTypeDescription
branchVisibilityObject, NullIn which Branch the Order Status is visible
dateCreatedStringDate and time when the Order Status was created
dateDeletedStringDate and time when the Order Status was deleted
dateUpdatedStringDate and time when the Order Status was last updated
deletedBooleanIf true, the Order Status has been deleted and archived
descriptionBRStringOrder Status label in Brasilian Portuguese
descriptionDEStringOrder Status label in German
descriptionDKStringOrder Status label in Dutch
descriptionENStringOrder Status label in English
descriptionESStringOrder Status label in Spanish
descriptionFRStringOrder Status label in French
descriptionITStringOrder Status label in Italian
descriptionPTStringOrder Status label in Portuguese
descriptionRUStringOrder Status label in Russian
descriptionUSStringOrder Status label in American English
idIntegerUnique identifier for the Order Status in ForceManager
wonBooleanIf true, the Order has been won
lostBooleanIf true, the Order has been lost
orderIntegerThe position of the Order Status in the Order Statuses value list
salesRepIdCreatedIntegerUnique identifier of the user who created the Order Status
salesRepIdDeletedIntegerUnique identifier of the user who deleted the Order Status
salesRepIdUpdatedIntegerUnique identifier of the user who last updated the Order Status

RESPONSE CODES

StatusDescription
200 OKShows if operation succeeded
400 Bad RequestShows when an invalid request or the requested service is not available
get/salesorderStatuses/{ID}

Request

  • Base URL: https://api.forcemanager.com/api/v4
  • URL: https://api.forcemanager.com/api/v4/salesorderStatuses/{ID}
  • Auth: API key in header X-Session-Key

Headers

Acceptstring

Response

Get Order Status

Changes

No recorded changes to this operation across all 1 revision of this API.