Retrieve a Record's Status

Use this API call to get the status of a record in Shape

POST /get/lead/status

To retrieve a record’s status from Shape, send an authorized POST request to

Request Body Parameters

Retrieve a lead’s status with these parameters. In this API call, only the Shape lead ID is required:

  • lead_id

    This is required in order for this API call to work. You should be passing this mapping with the Shape lead ID that you'd like to get the status of.

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.”


JSON request body formatting example:


     “lead_id”: 123,



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”: “Record status retrieved successfully.”,

     “recordID”: 123,

     “statusID”: 4236,

     “status”: “New”


Get in Touch

Our team of experts are here to help! Call our sales line at (888) 762-7211


Contact Sales