Retrieve Status Lists

Use this API call to retrieve status lists in Shape. Keep in mind, Shape supports multiple status lists.

GET /get/statuses

To retrieve status lists from Shape, send an authorized GET request to https://secure-api.setshape.com/api/get/statuses

Request Header

The authentication token must be passed in the request header for every API request. You can find and generate your authentication token in your system settings page under “API Integrations.”

Response

Upon success, the server returns HTTP codes and messages in the header with some additional elements and properties that are set by the server, such as id.

{
    "message": "Statues retrieved successfully",
    "statues": [
        {
            "id": 1,
            "title": "Sales Status",
            "status": [
                {
                    "id": 1,
                    "title": "New Prospect"
                },
                {
                    "id": 4,
                    "title": "Contacted - Follow Up"
                },
                {
                    "id": 7,
                    "title": "No Contact - Left Message"
                },
                {
                    "id": 10,
                    "title": "Bad Number - Email Sent"
                },
                {
                    "id": 16,
                    "title": "Active Working Deal"
                },
                {
                    "id": 40,
                    "title": "Contract Out"
                },
                {
                    "id": 43,
                    "title": "Deal Closed"
                },
                {
                    "id": 55,
                    "title": "Contact in Future"
                },
                {
                    "id": 67,
                    "title": "Do Not Contact"
                },
                {
                    "id": 70,
                    "title": "Not Interested"
                },
                {
                    "id": 73,
                    "title": "Return Lead - Credit"
                },
                {
                    "id": 277,
                    "title": "Bad Contact Info"
                },
            ]
        },
}