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
Method	Interface
GetLeaseInfo	Convergent Billing
GetResidentListInfo	Resident Management
GetResidentLedger	Transactions
Example: 5519027
x_property_idstringrequired
The external ID of the property from the integration vendor
Method	Interface
GetLeaseInfo	Convergent Billing
GetResidentListInfo	Resident Management
GetResidentLedger	Transactions
Example: 4829103
x_resident_idstring | nullnullablerequireddeprecated
Deprecated. Use residents_meta_data instead
Method	Interface
GetLeaseInfo	Convergent Billing
x_unit_idstring | nullnullablerequired
The external ID of the unit from the integration vendor
Method	Interface
GetLeaseInfo	Convergent Billing
GetResidentListInfo	Resident Management
Example: 7192044
residents_meta_data object[]
Known associated resident meta data
Array [
resident_idstringrequired
The Propexo unique identifier for the resident
Method	Interface
GetResidentListInfo	Resident Management
Example: cm0rpx0005exampleid000001
x_resident_typestring | nullnullablerequired
The external type of the resident from the integration vendor
Method	Interface
GetResidentListInfo	Resident Management
Example: H
resident_type_normalizedstring | nullnullablerequired
Resident type from Propexo
Method	Interface
GetResidentListInfo	Resident Management
Example: PRIMARY
Show 2 variants
• string
• stringPRIMARYSECONDARYGUARANTOROTHER
move_in_datestring | nullnullablerequired
The move-in date associated with the resident
Method	Interface
GetResidentListInfo	Resident Management
Example: 2021-02-09T00:00:00.000Z
move_out_datestring | nullnullablerequired
The move-out date associated with the resident
Method	Interface
GetResidentListInfo	Resident Management
Example: 2022-02-09T00:00:00.000Z
notice_datestring | nullnullablerequired
The date the resident gave notice
Method	Interface
GetResidentListInfo	Resident Management
Example: 2022-02-09T00: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
Method	Interface
GetLeaseInfo	Convergent Billing
Example: 2024-05-01T00:00:00.000Z
custom_dataobject | nullnullablerequired
deposit_amountnullrequired
The deposit amount associated with the lease
Notice
This field will always be null for REALPAGE_RPX
Example: null
deposit_amount_in_centsnullrequired
The deposit amount in cents associated with the lease
Notice
This field will always be null for REALPAGE_RPX
Example: null
deposit_datenullrequired
The deposit date associated with the lease
Notice
This field will always be null for REALPAGE_RPX
Example: null
end_datestring | nullnullablerequired
The end date associated with the lease
Method	Interface
GetLeaseInfo	Convergent Billing
GetResidentListInfo	Resident Management
Example: 2025-05-31T00:00:00.000Z
realized_move_in_datestring | nullnullablerequireddeprecated
DEPRECATED: Please use residents_meta_data to view resident move in dates
Method	Interface
GetLeaseInfo	Convergent Billing
realized_move_out_datestring | nullnullablerequireddeprecated
DEPRECATED: Please use residents_meta_data to view resident move out dates
Method	Interface
GetLeaseInfo	Convergent Billing
rent_amount_in_centsnumber | nullnullablerequired
The rent amount in cents for the lease
Method	Interface
GetLeaseInfo	Convergent Billing
Example: 185000
rent_amount_market_in_centsnullrequired
The market rent amount in cents for the lease
Notice
This field will always be null for REALPAGE_RPX
Example: null
rent_due_daynullrequired
The rent due day associated with the lease
Notice
This field will always be null for REALPAGE_RPX
Example: null
rent_due_datestring | nullnullablerequired
The rent due date associated with the lease
Method	Interface
GetLeaseInfo	Convergent Billing
Example: 2024-06-01T00:00:00.000Z
scheduled_move_in_datestring | nullnullablerequireddeprecated
DEPRECATED: Please use residents_meta_data to view resident move in dates
Method	Interface
GetLeaseInfo	Convergent Billing
scheduled_move_out_datenullrequireddeprecated
DEPRECATED: Please use residents_meta_data to view resident move out dates
Notice
This field will always be null for REALPAGE_RPX
Example: null
signature_datestring | nullnullablerequired
The date the lease was signed
Method	Interface
GetLeaseInfo	Convergent Billing
GetResidentListInfo	Resident Management
Example: 2024-05-20T00:00:00.000Z
start_datestring | nullnullablerequired
The start date associated with the lease
Method	Interface
GetLeaseInfo	Convergent Billing
GetResidentListInfo	Resident Management
Example: 2024-06-01T00:00:00.000Z
statusstring | nullnullablerequireddeprecated
DEPRECATED. Use status_normalized
Important
Deprecated in favor of status_normalized and status_raw
Method	Interface
GetLeaseInfo	Convergent Billing
GetResidentListInfo	Resident Management
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.
Method	Interface
GetLeaseInfo	Convergent Billing
GetResidentListInfo	Resident Management
Show 5 enum values
ACTIVEEVICTEDINACTIVEOTHERPENDING
Example: ACTIVE
status_rawstring | nullnullablerequired
The raw status associated with the lease
Method	Interface
GetLeaseInfo	Convergent Billing
GetResidentListInfo	Resident Management
Example: Current
termstring | nullnullablerequired
The lease term
Method	Interface
GetLeaseInfo	Convergent Billing
Example: 12 month term
typestring | nullnullablerequired
The type of lease
Method	Interface
GetLeaseInfo	Convergent Billing
GetResidentListInfo	Resident Management
Example: First Lease
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.
Method	Interface
GetResidentListInfo	Resident Management
Example: 1400A
write_off_amount_in_centsnullrequired
The write off amount for the lease, in cents
Notice
This field will always be null for REALPAGE_RPX
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 REALPAGE_RPX
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 (unless you also ingest resident charges or resident payments) which will increase your processed records count. Please contact support to enable.
Method	Interface
GetResidentLedger	Transactions
Example: 4595288
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 (unless you also ingest resident charges or resident payments) which will increase your processed records count. Please contact support to enable.
Method	Interface
GetResidentLedger	Transactions
Example: 45952.8800
past_due_balance_in_centsnumber | nullnullablerequired
The past due balance for the lease, in cents
Important
Hydrating this field requires making requests to an additional API (unless you also ingest resident charges or resident payments) which will increase your processed records count. Please contact support to enable.
Method	Interface
GetResidentLedger	Transactions
Example: 1519000
past_due_balance_rawstring | nullnullablerequired
The raw past due balance of the lease from the PMS
Important
Hydrating this field requires making requests to an additional API (unless you also ingest resident charges or resident payments) which will increase your processed records count. Please contact support to enable.
Method	Interface
GetResidentLedger	Transactions
Example: 15190.0000
unit_idstring | nullnullablerequired
The Propexo unique identifier for the unit
Method	Interface
GetLeaseInfo	Convergent Billing
Example: clxkwu2m60008t3oza63zbjzp
property_idstringrequired
The Propexo unique identifier for the property
Example: clwi5xiix000008l6ctdgafyh
integration_idstringrequired
The Propexo unique identifier for the integration
Example: clwh5u07w000508me66sfh3um
integration_vendorEnum20required
The property management system of record
Show 13 enum values
APPFOLIOBUILDIUMENTRATAMRIPROPERTYWAREPROPERTYWARE_RESTREALPAGEREALPAGE_RPXRENTMANAGERRENTVINERESMANYARDIYARDI_REST
Example: REALPAGE_RPX
services object[]required
List of services related to the lease
Notice
This field is not currently hydrated for REALPAGE_RPX
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 REALPAGE_RPX
lease_idstringrequired
The Propexo unique identifier for the lease
]

Errors

• 400Bad Request

  error objectrequired
  codestringrequired
  Example: invalid_request
  messagestringrequired
  Example: invalid request
  details object
  property name*any
  Example: {"details":{"issues":[{"code":"unrecognized_keys","keys":["foo"],"path":[],"message":"Unrecognized key(s) in object: 'foo'"}],"name":"ZodError"}}

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": "5519027",
    "x_property_id": "4829103",
    "x_unit_id": "7192044",
    "residents_meta_data": [
      {
        "resident_id": "cm0rpx0005exampleid000001",
        "x_resident_type": "H",
        "resident_type_normalized": "PRIMARY",
        "move_in_date": "2021-02-09T00:00:00.000Z",
        "move_out_date": "2022-02-09T00:00:00.000Z",
        "notice_date": "2022-02-09T00:00:00.000Z",
        "custom_data": "Unknown Type: object,null",
        "last_seen": "2024-03-22T10:59:45.119Z"
      }
    ],
    "application_date": "2024-05-01T00:00:00.000Z",
    "custom_data": "Unknown Type: object,null",
    "deposit_amount": null,
    "deposit_amount_in_cents": null,
    "deposit_date": null,
    "end_date": "2025-05-31T00:00:00.000Z",
    "rent_amount_in_cents": 185000,
    "rent_amount_market_in_cents": null,
    "rent_due_day": null,
    "rent_due_date": "2024-06-01T00:00:00.000Z",
    "signature_date": "2024-05-20T00:00:00.000Z",
    "start_date": "2024-06-01T00:00:00.000Z",
    "status_normalized": "ACTIVE",
    "status_raw": "Current",
    "term": "12 month term",
    "type": "First Lease",
    "unit_number": "1400A",
    "write_off_amount_in_cents": null,
    "write_off_amount_raw": null,
    "balance_amount_in_cents": 4595288,
    "balance_amount_raw": "45952.8800",
    "past_due_balance_in_cents": 1519000,
    "past_due_balance_raw": "15190.0000",
    "unit_id": "clxkwu2m60008t3oza63zbjzp",
    "property_id": "clwi5xiix000008l6ctdgafyh",
    "integration_id": "clwh5u07w000508me66sfh3um",
    "integration_vendor": "REALPAGE_RPX",
    "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"
      }
    ]
  }
}