Get all leads

GEThttps://api.propexo.com/v1/leads/

Authentication

AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

order-by string

Order the results by a field. Optionally include asc or desc preceded by a colon (default is asc). Example: ?order-by=updated_at:desc

Default value: created_at:desc

updated_at_gte string | null

Filter to records updated at or after this datetime. Format: ISO 8601 (e.g. 2026-01-01T00:00:00Z)

updated_at_lte string | null

Filter to records updated at or before this datetime. Format: ISO 8601 (e.g. 2026-12-31T23:59:59Z)

last_seen_gte string | null

Filter to records whose last_seen date is on or after this datetime. Format: ISO 8601 (e.g. 2026-01-01T00:00:00Z)

last_seen_lte string | null

Filter to records whose last_seen date is on or before this datetime. Format: ISO 8601 (e.g. 2026-12-31T23:59:59Z)

offset integer | null

Possible values: >= 0

Can be used for paginating results

Default value: 0

limit integer | null

Possible values: >= 0 and <= 250

A number between 1 and 250 to determine the number of results to return in a single query

Default value: 100

x_id string

The external lead id

x_property_id string

Deprecated: Use the Propexo property_id instead

location_id string

The Propexo unique identifier for the location associated with the property (exclusive to Rent Manager integrations). This is always null for non-Rent Manager integrations.

x_unit_id string

The external unit id

email_1 string

Lead email address

email_2 string

Lead email address alternate

property_id string

The Propexo property id

integration_id string

The Propexo integration id

integration_vendor string

Show 13 enum values

APPFOLIOBUILDIUMENTRATAMRIPROPERTYWAREPROPERTYWARE_RESTREALPAGEREALPAGE_RPXRENTMANAGERRENTVINERESMANYARDIYARDI_REST

The integration vendor for the lead.

phone_1 string

Possible values: Value must match regular expression ^[2-9]\d{9}$

Filter by phone number (10 digit format only)

Response

Successful response

meta objectrequired

offsetinteger

The offset of the first result

Possible values: >= 0

Example: 0

limitinteger

The number of results to return

Possible values: >= 0 and <= 250

Example: 100

orderBy object[]required

The order of the results

Array [

object

]

hasMoreboolean | nullnullable

Whether there are more results

totalinteger

The total number of results

Possible values: >= 0

Example: 1000

results object[]required

Array [

idstringrequired

The Propexo unique identifier for the lead

Example: clwktsp9v000008l31iv218hn

created_atstringrequired

The date record first entered Propexo

Example: 2024-03-21T15:38:08.337Z

updated_atstringrequired

The date record was last updated in Propexo

Example: 2024-03-22T10:59:45.119Z

last_seenstring | nullnullablerequired

The date the record was last seen from the PMS

Example: 2024-03-22T10:59:45.119Z

x_created_atnullrequired

The date the record first entered the integration vendor

Notice

This field will always be null for YARDI

Example: null

x_guestcard_idnullrequired

The external ID of the guestcard from the integration vendor

Notice

This field will always be null for YARDI

Example: null

x_idstringrequired

The external ID from the integration vendor

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetApplication_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: p0148291

x_leasing_agent_idnullrequired

The external ID of the leasing agent from the integration vendor

Notice

This field will always be null for YARDI

Example: null

x_property_idstringrequired

The external ID of the property from the integration vendor

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetApplication_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: oakridge

x_unit_idnullrequireddeprecated

DEPRECATED: Use x_unit_id_preferred instead

Notice

This field will always be null for YARDI

Example: null

x_unit_id_preferredstring[]required

The external IDs of the units from the integration vendor that the lead is interested in

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: ["312441"]

x_updated_atnullrequired

The date the record was last updated in the integration vendor

Notice

This field will always be null for YARDI

Example: null

x_lead_source_idnullrequired

The external ID of the lead source from the integration vendor

Notice

This field will always be null for YARDI

Example: null

address_1string | nullnullablerequired

The first address line associated with the lead

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: 1842 Cedar Avenue

address_2string | nullnullablerequired

The second address line associated with the lead

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: Apt 4B

citystring | nullnullablerequired

The city associated with the lead

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: Oakland

countrystring | nullnullablerequired

The country associated with the lead

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: United States

custom_data object | nullrequired

object

date_of_birthstring | nullnullablerequired

The date of birth associated with the lead

Interface	Method
ILS Guest Card	GetApplication_Login

Example: 1992-04-18T00:00:00.000Z

desired_amenitiesnullrequired

The desired amenities associated with the lead

Notice

This field will always be null for YARDI

Example: null

desired_floor_plan_idstring | nullnullablerequired

The external ID of desired floor plan associated with the lead

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: A2

desired_floor_plan_namenullrequired

The desired floor plan name

Notice

This field will always be null for YARDI

Example: null

desired_lease_term_in_monthsnullrequired

The desired lease term

Notice

This field will always be null for YARDI

Example: null

desired_max_rent_in_centsnumber | nullnullablerequired

The desired maximum rent

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: 280000

desired_max_square_ftnullrequired

The desired maximum square feet

Notice

This field will always be null for YARDI

Example: null

desired_min_rent_in_centsnumber | nullnullablerequired

The desired minimum rent

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: 180000

desired_min_square_ftnullrequired

The desired minimum square feet

Notice

This field will always be null for YARDI

Example: null

desired_num_bathroomsnullrequired

The desired number of bathrooms

Notice

This field will always be null for YARDI

Example: null

desired_num_bedroomsinteger | nullnullablerequired

The desired number of bedrooms

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: 2

desired_unit_numberstring | nullnullablerequired

The desired unit number

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: 204

desired_unit_typenullrequired

The desired unit type

Notice

This field will always be null for YARDI

Example: null

email_1string | nullnullablerequired

The primary email address associated with the lead

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: [email protected]

email_2nullrequired

The secondary email address associated with the lead

Notice

This field will always be null for YARDI

Example: null

first_namestring | nullnullablerequired

The first name associated with the lead

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: Maya

ilsnullrequired

The name of the Internet listing service

Notice

This field will always be null for YARDI

Example: null

last_namestring | nullnullablerequired

The last name associated with the lead

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: Chen

lead_sourcestring | nullnullablerequired

The lead source

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: Apartments.com

leasing_agentstring | nullnullablerequired

The name of the leasing agent

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: Jordan Hale

middle_namestring | nullnullablerequired

The middle name associated with the lead

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: Elena

notesnullrequired

Notes associated with the lead

Notice

This field will always be null for YARDI

Example: null

number_of_occupantsnullrequired

The number of occupants

Notice

This field will always be null for YARDI

Example: null

pet_detailsnullrequireddeprecated

DEPRECATED: Use the pets array instead

Notice

This field will always be null for YARDI

Example: null

pets object[]required

The pets associated with the lead

Array [

idstringrequired

The Propexo unique identifier for the lead pet

Example: clwktsp9v000008l31iv218hn

created_atstringrequired

The date record first entered Propexo

Example: 2024-03-21T15:38:08.337Z

updated_atstringrequired

The date record was last updated in Propexo

Example: 2024-03-22T10:59:45.119Z

last_seenstring | nullnullablerequired

The date the record was last seen from the PMS

Example: 2024-03-22T10:59:45.119Z

x_idstringrequired

The external ID from the integration vendor

Important

Pet data in Yardi requires additional configuration for your Propexo integration. Please contact Propexo support for more information.

Interface	Method
ILS Guest Card	GetApplication_Login

Example: cl8k2nqwe0022jsxq9ab1c2dz

age_in_yearsnumber | nullnullablerequired

The age in years of the lead pet

Important

Pet data in Yardi requires additional configuration for your Propexo integration. Please contact Propexo support for more information.

Interface	Method
ILS Guest Card	GetApplication_Login

Example: 3

breedstring | nullnullablerequired

The breed of the lead pet

Interface	Method
ILS Guest Card	GetApplication_Login

Example: Golden Retriever

colorstring | nullnullablerequired

The color of the lead pet

Interface	Method
ILS Guest Card	GetApplication_Login

Example: Golden

gender_rawstring | nullnullablerequired

The raw value for the gender of the lead pet

Interface	Method
ILS Guest Card	GetApplication_Login

Example: M

is_fixedboolean | nullnullablerequired

Whether the lead pet is fixed

Interface	Method
ILS Guest Card	GetApplication_Login

Example: true

is_service_animalboolean | nullnullablerequired

Whether the lead pet is a service animal

Interface	Method
ILS Guest Card	GetApplication_Login

namestring | nullnullablerequired

The name associated with the lead pet

Interface	Method
ILS Guest Card	GetApplication_Login

Example: Buddy

notesnullrequired

Notes associated with the lead pet

Notice

This field will always be null for YARDI

Example: null

typestring | nullnullablerequired

The type associated with the lead pet

Interface	Method
ILS Guest Card	GetApplication_Login

Example: Dog

weight_in_poundsnumber | nullnullablerequired

The weight in pounds of the lead pet

Interface	Method
ILS Guest Card	GetApplication_Login

Example: 50

custom_data object | nullrequired

object

]

phone_1_typestring | nullnullablerequired

Type of the primary phone number

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: cell

phone_1string | nullnullablerequired

Primary phone number associated with the lead

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: 4155550142

phone_2_typenullrequired

Type of the secondary phone number

Notice

This field will always be null for YARDI

Example: null

phone_2nullrequired

Secondary phone number associated with the lead

Notice

This field will always be null for YARDI

Example: null

statestring | nullnullablerequired

The state associated with the lead

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: CA

statusnullrequired

The raw status associated with the lead

Notice

This field will always be null for YARDI

Example: null

target_move_in_datestring | nullnullablerequired

The target move in date

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: 2024-08-01T00:00:00.000Z

zipstring | nullnullablerequired

The zip code associated with the lead

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: 94612

property_idstringrequired

The Propexo unique identifier for the property

Example: clwi5xiix000008l6ctdgafyh

lead_source_idnullrequired

The Propexo unique identifier for the lead source

Notice

This field will always be null for YARDI

Example: null

unit_id_preferredstring[]required

The Propexo unique identifiers for the units that the lead is interested in

Interface	Method
ILS Guest Card	GetYardiGuestActivity_Login
ILS Guest Card	GetYardiGuestActivity_Search

Example: ["testintegration:1:312441"]

integration_idstringrequired

The Propexo unique identifier for the integration

Example: clwh5u07w000508me66sfh3um

integration_vendorEnum24required

The property management system of record

Show 13 enum values

YARDIAPPFOLIOBUILDIUMENTRATAMRIPROPERTYWAREPROPERTYWARE_RESTREALPAGEREALPAGE_RPXRENTMANAGERRENTVINERESMANYARDI_REST

Example: YARDI

screenings object[]required

Notice

This field is not currently hydrated for YARDI

Array [

idstringrequired

The Propexo ID of the screening

Example: clwktsp9v000008l31iv218hn

created_atstringrequired

The date record first entered Propexo

Example: 2024-03-21T15:38:08.337Z

last_seenstringrequired

The date the record was last seen from the PMS

Example: 2024-03-22T10:59:45.119Z

x_idstringrequired

The external ID from the integration vendor

status_rawstring | nullnullablerequired

The status/results of the screening

Notice

This field is not currently hydrated for YARDI

screening_datestring | nullnullablerequired

The date the screening took place

Notice

This field is not currently hydrated for YARDI

]

Errors

400Bad Request

GET /v1/leads/
curl https://api.propexo.com/v1/leads/ \
     -H "Authorization: Bearer <token>"

200 Successful response
{
  "meta": {
    "offset": 0,
    "limit": 100,
    "orderBy": [
      {}
    ],
    "hasMore": true,
    "total": 1000
  },
  "results": [
    {
      "id": "clwktsp9v000008l31iv218hn",
      "created_at": "2024-03-21T15:38:08.337Z",
      "updated_at": "2024-03-22T10:59:45.119Z",
      "last_seen": "2024-03-22T10:59:45.119Z",
      "x_created_at": null,
      "x_guestcard_id": null,
      "x_id": "p0148291",
      "x_leasing_agent_id": null,
      "x_property_id": "oakridge",
      "x_unit_id_preferred": [
        "312441"
      ],
      "x_updated_at": null,
      "x_lead_source_id": null,
      "address_1": "1842 Cedar Avenue",
      "address_2": "Apt 4B",
      "city": "Oakland",
      "country": "United States",
      "custom_data": "Unknown Type: object,null",
      "date_of_birth": "1992-04-18T00:00:00.000Z",
      "desired_amenities": null,
      "desired_floor_plan_id": "A2",
      "desired_floor_plan_name": null,
      "desired_lease_term_in_months": null,
      "desired_max_rent_in_cents": 280000,
      "desired_max_square_ft": null,
      "desired_min_rent_in_cents": 180000,
      "desired_min_square_ft": null,
      "desired_num_bathrooms": null,
      "desired_num_bedrooms": 2,
      "desired_unit_number": "204",
      "desired_unit_type": null,
      "email_1": "[email protected]",
      "email_2": null,
      "first_name": "Maya",
      "ils": null,
      "last_name": "Chen",
      "lead_source": "Apartments.com",
      "leasing_agent": "Jordan Hale",
      "middle_name": "Elena",
      "notes": null,
      "number_of_occupants": null,
      "pets": [
        {
          "id": "clwktsp9v000008l31iv218hn",
          "created_at": "2024-03-21T15:38:08.337Z",
          "updated_at": "2024-03-22T10:59:45.119Z",
          "last_seen": "2024-03-22T10:59:45.119Z",
          "x_id": "cl8k2nqwe0022jsxq9ab1c2dz",
          "age_in_years": 3,
          "breed": "Golden Retriever",
          "color": "Golden",
          "gender_raw": "M",
          "is_fixed": true,
          "is_service_animal": true,
          "name": "Buddy",
          "notes": null,
          "type": "Dog",
          "weight_in_pounds": 50,
          "custom_data": "Unknown Type: object,null"
        }
      ],
      "phone_1_type": "cell",
      "phone_1": "4155550142",
      "phone_2_type": null,
      "phone_2": null,
      "state": "CA",
      "status": null,
      "target_move_in_date": "2024-08-01T00:00:00.000Z",
      "zip": "94612",
      "property_id": "clwi5xiix000008l6ctdgafyh",
      "lead_source_id": null,
      "unit_id_preferred": [
        "testintegration:1:312441"
      ],
      "integration_id": "clwh5u07w000508me66sfh3um",
      "integration_vendor": "YARDI",
      "screenings": [
        {
          "id": "clwktsp9v000008l31iv218hn",
          "created_at": "2024-03-21T15:38:08.337Z",
          "last_seen": "2024-03-22T10:59:45.119Z",
          "x_id": "string",
          "status_raw": "string",
          "screening_date": "string"
        }
      ]
    }
  ]
}

Get all leads

Authentication​

Query parameters​

Response​

Errors​

Authentication

Query parameters

Response

Errors