getServiceRequestInfo

get

getServiceRequestInfo

The application will poll on this API method after the rescue request has been BOOKED.This method returns all rescue service details including service status, predective/updated ETA, disablement & destination addresses, providers & driver info etc.

Resource URL

https://api-sandbox.arity.com/services/roadside/v1/rescue/reqId/{reqId}

Query Parameters


Name Values Description
sessionId
(required)

Session ID created via the createSession Method eg. 3ec6ac0-65e5-4db1-abf2-133bd30edede


Header Parameters


Name Values Description
Content-Type

Authorization
(required)

Bearer Token generated from OAuth API (client_credentials grant)

reqId Request id produced from a successful response of the create service API. true

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Response Error Details

  • HTTP Code
    Error Code
    Description
  • 400
    400

    Bad Request response

  • 401
    401

    Unauthorized response

  • 500
    500

    Service Error response

Resource Summary

Security

None

Category

Dispatch & Track Rescue

Name Type Description
Name Type Description
serviceRequest
.requestId
stringThe requestId created for the rescue
serviceRequest
.callId
stringA unique reference numbe for the dispatch if user were to call assistance
serviceRequest
.consumerFirstName
stringFirst name of consumer
serviceRequest
.consumerLastName
stringLast name of consumer
serviceRequest
.consumerVehicleMake
stringMake of Vehicle
serviceRequest
.consumerVehicleModel
stringModel of Vehicle
serviceRequest
.consumerVehicleYear
stringYear of Vehicle
serviceRequest
.consumerVehicleColor
stringColor of Vehicle
serviceRequest
.serviceType
stringType of rescue requested (Gas, Tow, Changetire, Battery, Lockout)
serviceRequest
.cost
stringThe cost of the service
serviceRequest
.status
stringThe current status of the job (BOOKED, EN-ROUTE, APPROACHING, ARRIVED_ONSITE, COMPLETED)
serviceRequest
.requestCreationTime
stringThe date and time the rescue was requested (2017-02-01T21:03:01.958Z)
serviceRequest
.purchaseOrderNumber
stringThe purchase order for the rescue
serviceRequest
.eta
stringThe estimated time of arrival in minutes (40)
serviceRequest
.etaTime
stringThe eta time in GMC: 2017-02-01T21:43:01.958Z
serviceRequest
.updatedEta
stringUpdate eta is provided when the rescuer or the customer service rep provides it
serviceRequest
.updatedEtaTime
stringThe update eta time in GMC: 2017-02-01T21:43:01.958Z
serviceRequest
.predictedEta
stringPredictive eta is provided when the rescuer is fully digital and provide their GPS coordinates
serviceRequest
.predictedEtaTime
stringThe predictive eta time in GMC: 2017-02-01T21:43:01.958Z
serviceRequest
.consumerTimezone
stringThe time zone where the consumer is located
serviceRequest
.overCostAmount
numberThe amount of the rescue that is over the established cost
serviceRequest
.coverageAmount
numberThe ammount of the rescue is covered
serviceRequest
.incidentAddress
.addressLine1
string(Optional) Disablement address
serviceRequest
.incidentAddress
.addressLine2
string(Optional) Disablement address continued
serviceRequest
.incidentAddress
.city
string(Optional) City
serviceRequest
.incidentAddress
.zipCode
string(Optional)Zipcode
serviceRequest
.incidentAddress
.country
string(Optional) USA
serviceRequest
.incidentAddress
.state
string(Optional) State
serviceRequest
.incidentAddress
.latitude
number(Required) Coordinate for latitude
serviceRequest
.incidentAddress
.longitude
number(Required) Coordinate for longitude
serviceRequest
.destinationAddress
.addressLine1
string(Optional) Disablement address
serviceRequest
.destinationAddress
.addressLine2
string(Optional) Disablement address continued
serviceRequest
.destinationAddress
.city
string(Optional) City
serviceRequest
.destinationAddress
.zipCode
string(Optional)Zipcode
serviceRequest
.destinationAddress
.country
string(Optional) USA
serviceRequest
.destinationAddress
.state
string(Optional) State
serviceRequest
.destinationAddress
.latitude
number(Required) Coordinate for latitude
serviceRequest
.destinationAddress
.longitude
number(Required) Coordinate for longitude
provider
.id
stringThe provider identification number
provider
.companyName
stringThe name of the provider
provider
.contactName
stringThe contact person for the provider
provider
.contactNumber
stringThe provider contact number
provider
.type
stringThe type of rescue being provided
provider
.providerAddress
.addressLine1
string(Optional) Disablement address
provider
.providerAddress
.addressLine2
string(Optional) Disablement address continued
provider
.providerAddress
.city
string(Optional) City
provider
.providerAddress
.zipCode
string(Optional)Zipcode
provider
.providerAddress
.country
string(Optional) USA
provider
.providerAddress
.state
string(Optional) State
provider
.providerAddress
.latitude
number(Required) Coordinate for latitude
provider
.providerAddress
.longitude
number(Required) Coordinate for longitude
driver
.id
stringThe identification number for the driver
driver
.name
stringFull name of driver
driver
.firstName
stringDriver first name
driver
.lastName
stringDriver last name
driver
.latitude
numberThe latitude of the driver
driver
.longitude
numberThe longitude of the driver
driver
.contactNumber
stringThe contact number for the driver
driver
.driverProfileImageurl
stringNot supported: The URL to the drivers picture
driver
.driverEquipmentImageurl
stringNot supported: The URL to the drivers vehicle

Working...

© 2019 Arity, LLC. All rights reserved.  | Privacy Policy | Terms of Use | Legacy APIs