API Reference

Get Statuses

Retrieve the account’s configured statuses. Nested status values are account-defined.

GEThttps://secure-api.setshape.com/api/get/statuses/{crmid}

Replace {crmid} with your Shape system ID — found on the API Integrations page. Every request also needs your auth header — see Using Shape APIs.

Example request

curl --request GET 
  --url "https://secure-api.setshape.com/api/get/statuses/{crmid}" 
  --header "Authorization: {YOUR_API_AUTHORIZATION_KEY}" 
  --header "Accept: application/json"

Main and sub-status lists are also available:

GET /api/get/main-statuses/{crmid}
GET /api/get/sub-statuses/{main_status_id}/{crmid}

Example response

{
  "message": "Statuses fetched successfully",
  "statuses": [ ... account-defined values ... ]
}