List Leads

GET /v1/leads

List the leads RentSimple holds for your company. Returns the most recent leads first and supports basic filtering and pagination via query parameters.

Query parameters

Param	Type	Required	Description
`status`	string	no	Filter by lead status
`source`	string	no	Filter by acquisition source
`since`	string	no	ISO-8601 timestamp; return leads created at or after this time
`limit`	number	no	Max results to return (default `50`, max `200`)

Lead status values

Value	Meaning
`New`	Lead just entered, no outreach yet
`Engaged`	Lead is actively in conversation with the agent
`FollowUp`	Agent is following up after a lull
`NeedsAttention`	Flagged for a human teammate to review
`DroppedOff`	Lead went unresponsive

Example

Request


curl -X GET "https://rentsimple.ai/api/v1/leads?status=Engaged&limit=25" \
  -H "Authorization: Bearer $RENTSIMPLE_API_KEY"

Response — 200 OK


{
  "data": [
    {
      "id": "L_8fK2",
      "firstName": "Jordan",
      "lastName": "Lee",
      "email": "jordan.lee@example.com",
      "phone": "+14155550123",
      "status": "Engaged",
      "source": "Website",
      "createdAt": "2026-06-05T14:22:08Z",
      "updatedAt": "2026-06-05T14:22:40Z"
    }
  ]
}

Errors

Status	Message	Cause
`401`	Unauthorized	Missing or invalid API key
`400`	Invalid query	A query parameter failed validation