Get a lease by ID

GEThttps://api.propexo.com/v1/leases/:lease_id

Authentication

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

Path parameters

lease_id stringrequired

The ID of the resource.

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

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 objectrequired

idstringrequired

The Propexo unique identifier for the lease

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

Interface	Method
Receivables	/Receivables/GetAccounts
Lead Management	/MITS/SearchProspects
Leasing	/Leasing/GetProspectChanges
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts
Leasing	/Leasing/GetApplicantsAndCurrentResidents

Example: a4c8e2f1-7b30-4d19-9e56-3f82c1d0ab47

x_property_idstringrequired

The external ID of the property from the integration vendor

Interface	Method
Receivables	/Receivables/GetAccounts
Lead Management	/MITS/SearchProspects
Leasing	/Leasing/GetProspectChanges
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts
Leasing	/Leasing/GetApplicantsAndCurrentResidents

Example: 7c4e1a90-2b58-4f63-a1d7-e90c5b28f416

x_resident_idnullrequireddeprecated

Deprecated. Use residents_meta_data instead

Notice

This field will always be null for RESMAN

Example: null

x_unit_idstring | nullnullablerequired

The external ID of the unit from the integration vendor

Interface	Method
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts

Example: 7c5d3a37-2715-4cad-84d6-8d34d47b752d

residents_meta_data object[]

Known associated resident meta data

Array [

resident_idstringrequired

The Propexo unique identifier for the resident

Interface	Method
Leasing	/Leasing/GetProspectChanges
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts
Residents	/MITS/SearchProspects, /Receivables/GetAccounts
Leasing	/Leasing/GetApplicantsAndCurrentResidents

Example: clyq4plkc0002ysoz5y4r9o2y

x_resident_typestring | nullnullablerequired

The external type of the resident from the integration vendor

Important

This field is only available from ResMan for the current lease and is not available on future leases.

Interface	Method
Leasing	/Leasing/GetApplicantsAndCurrentResidents

Example: Head of Household

resident_type_normalizedstring | nullnullablerequired

Resident type from Propexo

Important

This field is only available from ResMan for the current lease and is not available on future leases.

Interface	Method
Leasing	/Leasing/GetApplicantsAndCurrentResidents

Example: PRIMARY

Show 2 variants

string
stringPRIMARYSECONDARYGUARANTOROTHER

move_in_datestring | nullnullablerequired

The move-in date associated with the resident

Interface	Method
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts
Leasing	/Leasing/GetApplicantsAndCurrentResidents

Example: 2024-11-22T00:00:00.000Z

move_out_datestring | nullnullablerequired

The move-out date associated with the resident

Interface	Method
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts
Leasing	/Leasing/GetApplicantsAndCurrentResidents

Example: 2025-11-22T00:00:00.000Z

notice_datestring | nullnullablerequired

The date the resident gave notice

Interface	Method
Leasing	/Leasing/GetProspectChanges

Example: 2024-03-21T00:00:00.000Z

custom_dataobject | nullnullablerequired

last_seenstring | nullnullablerequired

The date the record was last seen from the PMS

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

]

application_datestring | nullnullablerequired

The application date associated with the lease

Interface	Method
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts

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

custom_dataobject | nullnullablerequired

deposit_amountnullrequired

The deposit amount associated with the lease

Notice

This field will always be null for RESMAN

Example: null

deposit_amount_in_centsnullrequired

The deposit amount in cents associated with the lease

Notice

This field will always be null for RESMAN

Example: null

deposit_datenullrequired

The deposit date associated with the lease

Notice

This field will always be null for RESMAN

Example: null

end_datestring | nullnullablerequired

The end date associated with the lease

Interface	Method
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts
Leasing	/Leasing/GetApplicantsAndCurrentResidents

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

realized_move_in_datestring | nullnullablerequireddeprecated

DEPRECATED: Please use residents_meta_data to view resident move in dates

Interface	Method
Leasing	/Leasing/GetProspectChanges
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts

realized_move_out_datestring | nullnullablerequireddeprecated

DEPRECATED: Please use residents_meta_data to view resident move out dates

Interface	Method
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts

rent_amount_in_centsnumber | nullnullablerequired

The rent amount in cents for the lease

Interface	Method
Leasing (Partner API)	/Leasing/Leases
Leasing	/Leasing/GetApplicantsAndCurrentResidents

Example: 100000

rent_amount_market_in_centsnullrequired

The market rent amount in cents for the lease

Notice

This field will always be null for RESMAN

Example: null

rent_due_daynullrequired

The rent due day associated with the lease

Notice

This field will always be null for RESMAN

Example: null

rent_due_datenullrequired

The rent due date associated with the lease

Notice

This field will always be null for RESMAN

Example: null

scheduled_move_in_datestring | nullnullablerequireddeprecated

DEPRECATED: Please use residents_meta_data to view resident move in dates

Interface	Method
Leasing	/Leasing/GetProspectChanges
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts

scheduled_move_out_datestring | nullnullablerequireddeprecated

DEPRECATED: Please use residents_meta_data to view resident move out dates

Interface	Method
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts

signature_datestring | nullnullablerequired

The date the lease was signed

Important

This data can only be retrieved from a high-volume endpoint. Please contact support if you need it enabled.

Interface	Method
Lead Management	/MITS/SearchProspects
Leasing	/Leasing/GetProspectChanges
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts

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

start_datestring | nullnullablerequired

The start date associated with the lease

Important

Historical leases are available via the ResMan partner API upon request. Please contact [email protected] if needed

Interface	Method
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts
Leasing	/Leasing/GetApplicantsAndCurrentResidents

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

statusnullrequireddeprecated

DEPRECATED. Use status_normalized

Important

Deprecated in favor of status_normalized and status_raw Deprecated: see status_normalized and status_raw

Notice

This field will always be null for RESMAN

Example: null

status_normalizedstring | nullnullablerequired

The normalized status for the lease. Note that the status may be called "EVICTED" but this can also refer to an active resident undergoing a current eviction. This varies per PMS.

Interface	Method
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts
Leasing	/Leasing/GetApplicantsAndCurrentResidents

Show 5 enum values

ACTIVEEVICTEDINACTIVEOTHERPENDING

Example: ACTIVE

status_rawstring | nullnullablerequired

The raw status associated with the lease

Interface	Method
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts
Leasing	/Leasing/GetApplicantsAndCurrentResidents

Example: Current

termnullrequired

The lease term

Notice

This field will always be null for RESMAN

Example: null

typenullrequired

The type of lease

Notice

This field will always be null for RESMAN

Example: null

unit_numberstring | nullnullablerequired

The unit number associated with the lease. This isn't always provided by PMS vendors, but may be the only data provided to identify a unit associated with a service request in some cases.

Interface	Method
Leasing (Partner API)	/Leasing/Leases
Leasing (Partner API)	/Leasing/MoveOuts
Leasing	/Leasing/GetApplicantsAndCurrentResidents

Example: 14

write_off_amount_in_centsnullrequired

The write off amount for the lease, in cents

Notice

This field will always be null for RESMAN

Example: null

write_off_amount_rawnullrequired

The raw write off amount of the lease from the PMS

Notice

This field will always be null for RESMAN

Example: null

balance_amount_in_centsnumber | nullnullablerequired

The balance amount for the lease, in cents

Important

Hydrating this field requires making requests to an additional API which will increase your processed records count. Please contact support to enable.

Interface	Method
Receivables	/Receivables/GetAccounts

Example: 125000

balance_amount_rawstring | nullnullablerequired

The raw balance amount of the lease from the PMS

Important

Hydrating this field requires making requests to an additional API which will increase your processed records count. Please contact support to enable.

Interface	Method
Receivables	/Receivables/GetAccounts

Example: 1250.00

past_due_balance_in_centsnullrequired

The past due balance for the lease, in cents

Notice

This field will always be null for RESMAN

Example: null

past_due_balance_rawnullrequired

The raw past due balance of the lease from the PMS

Notice

This field will always be null for RESMAN

Example: null

unit_idnullrequired

The Propexo unique identifier for the unit

Notice

This field will always be null for RESMAN

Example: null

property_idstringrequired

The Propexo unique identifier for the property

Example: clwi5xiix000008l6ctdgafyh

integration_idstringrequired

The Propexo unique identifier for the integration

Example: clwh5u07w000508me66sfh3um

integration_vendorEnum23required

The property management system of record

Show 13 enum values

APPFOLIOBUILDIUMENTRATAMRIPROPERTYWAREPROPERTYWARE_RESTREALPAGEREALPAGE_RPXRENTMANAGERRENTVINERESMANYARDIYARDI_REST

Example: RESMAN

services object[]required

List of services related to the lease

Notice

This field is not currently hydrated for RESMAN

Array [

idstringrequired

The Propexo unique identifier for the lease service

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_seenstringrequired

The date the record was last seen from the PMS

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

namestringrequired

The name of the lease service

Notice

This field is not currently hydrated for RESMAN

lease_idstringrequired

The Propexo unique identifier for the lease

]

Errors

400Bad Request

GET /v1/leases/:lease_id
curl https://api.propexo.com/v1/leases/:lease_id \
     -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_id": "a4c8e2f1-7b30-4d19-9e56-3f82c1d0ab47",
    "x_property_id": "7c4e1a90-2b58-4f63-a1d7-e90c5b28f416",
    "x_unit_id": "7c5d3a37-2715-4cad-84d6-8d34d47b752d",
    "residents_meta_data": [
      {
        "resident_id": "clyq4plkc0002ysoz5y4r9o2y",
        "x_resident_type": "Head of Household",
        "resident_type_normalized": "PRIMARY",
        "move_in_date": "2024-11-22T00:00:00.000Z",
        "move_out_date": "2025-11-22T00:00:00.000Z",
        "notice_date": "2024-03-21T00:00:00.000Z",
        "custom_data": "Unknown Type: object,null",
        "last_seen": "2024-03-22T10:59:45.119Z"
      }
    ],
    "application_date": "2024-01-01T00:00:00.000Z",
    "custom_data": "Unknown Type: object,null",
    "deposit_amount": null,
    "deposit_amount_in_cents": null,
    "deposit_date": null,
    "end_date": "2024-01-01T00:00:00.000Z",
    "rent_amount_in_cents": 100000,
    "rent_amount_market_in_cents": null,
    "rent_due_day": null,
    "rent_due_date": null,
    "signature_date": "2024-01-02T00:00:00.000Z",
    "start_date": "2024-01-01T00:00:00.000Z",
    "status_normalized": "ACTIVE",
    "status_raw": "Current",
    "term": null,
    "type": null,
    "unit_number": "14",
    "write_off_amount_in_cents": null,
    "write_off_amount_raw": null,
    "balance_amount_in_cents": 125000,
    "balance_amount_raw": "1250.00",
    "past_due_balance_in_cents": null,
    "past_due_balance_raw": null,
    "unit_id": null,
    "property_id": "clwi5xiix000008l6ctdgafyh",
    "integration_id": "clwh5u07w000508me66sfh3um",
    "integration_vendor": "RESMAN",
    "services": [
      {
        "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",
        "name": "string",
        "lease_id": "string"
      }
    ]
  }
}

Get a lease by ID

Authentication​

Path parameters​

Query parameters​

Response​

Errors​

Authentication

Path parameters

Query parameters

Response

Errors