Get a service request by ID

GEThttps://api.propexo.com/v1/service-requests/:service_request_id

Authentication

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

Path parameters

service_request_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 service request
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
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: 00000001
x_property_idstringrequired
The external ID of the property from the integration vendor
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: 100
x_location_idnullrequired
The external ID of the location (exclusive to Rent Manager integrations). This is always null for non-Rent Manager integrations.
Notice
This field will always be null for MRI
Example: null
x_unit_idstring | nullnullablerequired
The external ID of the unit from the integration vendor
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: 22
x_sub_task_idnullrequired
The external ID of the sub task from the integration vendor
Notice
This field will always be null for MRI
Example: null
access_is_authorizedboolean | nullnullablerequired
Whether or not the tenant has granted permission to enter the unit associated with the service request
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: true
access_notesnullrequired
Notes regarding access to the unit associated with the service request
Notice
This field will always be null for MRI
Example: null
buildingnullrequired
The building name associated with the service request
Notice
This field will always be null for MRI
Example: null
completion_notesstring | nullnullablerequired
Closing notes associated with the service request
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: Completed by John Doe
date_completedstring | nullnullablerequired
The date the service request was completed
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: 2015-08-12T00:00:00.000Z
date_createdstring | nullnullablerequired
The date the service request was created
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: 2021-01-01T00:00:00.000Z
date_duenullrequired
The due date associated with the service request
Notice
This field will always be null for MRI
Example: null
date_scheduledstring | nullnullablerequired
The date the service request is scheduled
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: 2015-08-12T00:00:00.000Z
notesnullrequireddeprecated
DEPRECATED: Please use 'history' for reading notes regarding the service request
Notice
This field will always be null for MRI
Example: null
service_categorystring | nullnullablerequired
The category of service request
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: Plumbing
service_descriptionstring | nullnullablerequired
A description of the service request
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: Leaky Faucet
service_detailsstring | nullnullablerequired
Details about the service request
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: My kitchen sink is leaking
service_prioritystring | nullnullablerequired
The priority level associated with the service request
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: High
status_rawstring | nullnullablerequired
The raw status associated with the service request
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: Work Completed
vendor_notesnullrequired
Vendor/technician notes associated with the service request
Notice
This field will always be null for MRI
Example: null
unit_numbernullrequired
The unit number associated with the service request. 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.
Notice
This field will always be null for MRI
Example: null
order_numberstring | nullnullablerequired
The order number of the service request
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: 1234567890
integration_idstringrequired
The Propexo unique identifier for the integration
Example: clwh5u07w000508me66sfh3um
integration_vendorEnum16required
The property management system of record
Show 13 enum values
APPFOLIOBUILDIUMENTRATAMRIPROPERTYWAREPROPERTYWARE_RESTREALPAGEREALPAGE_RPXRENTMANAGERRENTVINERESMANYARDIYARDI_REST
Example: MRI
property_idstringrequired
The Propexo unique identifier for the property
Example: clwi5xiix000008l6ctdgafyh
unit_idstring | nullnullablerequired
The Propexo unique identifier for the unit
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: testintegration:100:E-22
employee_idstring | nullnullablerequired
The Propexo unique identifier for the employee
Method
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialServiceRequests
Example: testintegration:100:MATT
vendors object[]required
List of vendor IDs associated with the service request
Notice
This field is not currently hydrated for MRI
Array [
vendor_idstringrequired
Notice
This field is not currently hydrated for MRI
]
history object[]required
History of notes and/or updates related to the service request
Notice
This field is not currently hydrated for MRI
Array [
idstringrequired
The Propexo unique identifier for the service request history
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
x_idstringrequired
The external ID from the integration vendor
x_created_atstring | nullnullablerequired
The date the record first entered the integration vendor
Notice
This field is not currently hydrated for MRI
notesstringrequired
Notes describing the service request history
Notice
This field is not currently hydrated for MRI
creator_namestring | nullnullablerequired
The name of the person or user that created the service request history
Notice
This field is not currently hydrated for MRI
status_rawstring | nullnullablerequired
The raw status from the service request history
Notice
This field is not currently hydrated for MRI
service_request_idstringrequired
The Propexo unique identifier for the service request
]
employees object[]required
An array of all employees assigned to the service request
Array [
idstringrequired
The Propexo unique identifier for the employee
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
/mriapiservices/api.asp?$api=MRI_S-PMFM_WorkOrderEmployees
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialLeasingConsultants
Example: MATT
namestring | nullnullablerequired
The name associated with the employee
Method
/mriapiservices/api.asp?$api=MRI_S-PMFM_WorkOrderEmployees
/mriapiservices/api.asp?$api=MRI_S-PMRM_ResidentialLeasingConsultants
Example: John Doe
]

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/service-requests/:service_request_id

curl https://api.propexo.com/v1/service-requests/:service_request_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": "00000001",
    "x_property_id": "100",
    "x_location_id": null,
    "x_unit_id": "22",
    "x_sub_task_id": null,
    "access_is_authorized": true,
    "access_notes": null,
    "building": null,
    "completion_notes": "Completed by John Doe",
    "date_completed": "2015-08-12T00:00:00.000Z",
    "date_created": "2021-01-01T00:00:00.000Z",
    "date_due": null,
    "date_scheduled": "2015-08-12T00:00:00.000Z",
    "service_category": "Plumbing",
    "service_description": "Leaky Faucet",
    "service_details": "My kitchen sink is leaking",
    "service_priority": "High",
    "status_raw": "Work Completed",
    "vendor_notes": null,
    "unit_number": null,
    "order_number": "1234567890",
    "integration_id": "clwh5u07w000508me66sfh3um",
    "integration_vendor": "MRI",
    "property_id": "clwi5xiix000008l6ctdgafyh",
    "unit_id": "testintegration:100:E-22",
    "employee_id": "testintegration:100:MATT",
    "vendors": [
      {
        "vendor_id": "string"
      }
    ],
    "history": [
      {
        "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": "string",
        "x_created_at": "string",
        "notes": "string",
        "creator_name": "string",
        "status_raw": "string",
        "service_request_id": "string"
      }
    ],
    "employees": [
      {
        "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": "MATT",
        "name": "John Doe"
      }
    ]
  }
}