createTowRequest
createTowRequest
post
createTowRequest
Initiates a service request for a TOW service based on factors such as destination address, service type, vehicle, etc., which will be created from the input collected.
Resource URL
https://api-sandbox.arity.com/services/roadside/v1/rescue/tow
Header Parameters
| Name | Values | Description |
|---|---|---|
| Content-Type |
|
|
|
Authorization
(required) |
Bearer Token generated from OAuth API (client_credentials grant) |
Request Body
{1
{2
"sessionId": "",
3
"serviceRequest": {4
"appId": "",
5
"routeCSR": "",
6
"ppuFlag": "",
7
"CCardBundle": "",
8
"partnerTransactionId": "",
9
"firstName": "",
10
"lastName": "",
11
"email": "",
12
"contactNumber": "",
13
"consumerId": "",
14
"deviceTimeZone": "",
15
"additionalComments": "",
16
"disablementAddress": {17
"addressLine1": "",
18
"addressLine2": "",
19
"city": "",
20
"zipCode": "",
21
"country": "",
22
"state": "",
23
"latitude": 0,
24
"longitude": 0
25
},
26
"destinationAddress": {27
"addressLine1": "",
28
"addressLine2": "",
29
"city": "",
30
"zipCode": "",
31
"country": "",
32
"state": "",
33
"latitude": 0,
34
"longitude": 0
35
},
36
"vehicles": [37
{38
"year": "",
39
"model": "",
40
"make": "",
41
"color": "",
42
"vin": "",
43
"equipmentClass": ""
44
}
45
]
46
}
47
}
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 CodeError CodeDescription
-
400400
Bad Request response
-
401401
Unauthorized response
-
500500
Service Error response
Resource Summary |
|
|
Security |
None |
|
Category |
Determine Service |
| Name | Type | Description |
|---|---|---|
| sessionId | string | Session ID created via the createSession Method eg. 3ec6ac0-65e5-4db1-abf2-133bd30edede |
| serviceRequest .appId | string | (Required) The unique application ID |
| serviceRequest .routeCSR | string | (Optional) Flag used for Whitelable apps, to directly transfer the dispatch to the CSR instead of routing it to a Provider |
| serviceRequest .ppuFlag | string | (Optional) Flag to indicate if this is a Pay Per Use rescue |
| serviceRequest .CCardBundle | string | (Optional) The credit card bundle to be sent for the PPU use case |
| serviceRequest .partnerTransactionId | string | (Optional) Unique reference number from partner system to post to ARS database so that it can be tied to ARS id for that dispatch |
| serviceRequest .firstName | string | (Required) First Name |
| serviceRequest .lastName | string | (Required) Last Name |
| serviceRequest | string | (Required) email address |
| serviceRequest .contactNumber | string | (Required) Phone number |
| serviceRequest .consumerId | string | (Required) The ID associated with the individual making the request. Usually the email address eg. appconsumer@emaiaddress.com |
| serviceRequest .deviceTimeZone | string | (Optional)The time zone where the consume is located |
| serviceRequest .additionalComments | string | (Optional) Contains additional comments collected from the consumer |
| serviceRequest .disablementAddress .addressLine1 | string | (Optional) Disablement address |
| serviceRequest .disablementAddress .addressLine2 | string | (Optional) Disablement address continued |
| serviceRequest .disablementAddress .city | string | (Optional) City |
| serviceRequest .disablementAddress .zipCode | string | (Optional)Zipcode |
| serviceRequest .disablementAddress .country | string | (Optional) USA |
| serviceRequest .disablementAddress .state | string | (Optional) State |
| serviceRequest .disablementAddress .latitude | number | (Required) Coordinate for latitude |
| serviceRequest .disablementAddress .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 |
| serviceRequest .vehicles | array | |
| serviceRequest .vehicles[] .year | string | (Required) Year of Vehicle |
| serviceRequest .vehicles[] .model | string | (Required) Vehicle Model |
| serviceRequest .vehicles[] .make | string | (Required) Vehicle Make |
| serviceRequest .vehicles[] .color | string | (Required) Vehicle Coler |
| serviceRequest .vehicles[] .vin | string | Vehicle Identification Number |
| serviceRequest .vehicles[] .equipmentClass | string | (Required) The classifcation of the vehicle. Light (1) <10,000 lbs. Medium (2) 10,001 - 26,000 lbs. Heavy (3) >26,001 lbs. |
| Name | Type | Description |
|---|---|---|
| requestId | string | The request ID for the rescue |
| sessionId | string | The session ID for the rescue |
| callId | string | A unique reference numbe for the dispatch if user were to call assistance |
| message | string | Message sent as part of the response |
Working...