Update status by Transaction ID
curl --request POST \
--url https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version} \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"status": "EN_ROUTE",
"griddID": "4starlimo",
"resNo": "756333",
"requesterResNo": "12343",
"transactionId": "c1df1d28-0608-4df7-b268-cc68ba175ed6",
"totalAmount": "124.75",
"providerNote": "<string>",
"LocalTimestamp": "2016-04-13T19:15:00",
"UTCtimestamp": "2016-04-14T04:15:00",
"chauffeur": {
"chauffeurId": "01-abc",
"firstName": "Joe",
"lastName": "Smith",
"email": "joe@limo1.com",
"phoneNumber": "212.222.2222",
"picURL": "<string>"
},
"vehicle": {
"vehicleId": "101",
"vehicleType": "sedan",
"make": "BMW",
"model": "750iL",
"year": "2017",
"vin": "<string>",
"mileage": "<string>",
"passengerCount": "3"
},
"fees": [
{
"code": "base",
"currency": "USD",
"description": "Base charges",
"fee": "75.00",
"percent": "<string>",
"reimbursable": "<string>",
"type": "EXPENSE"
}
]
}
'import requests
url = "https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version}"
payload = {
"status": "EN_ROUTE",
"griddID": "4starlimo",
"resNo": "756333",
"requesterResNo": "12343",
"transactionId": "c1df1d28-0608-4df7-b268-cc68ba175ed6",
"totalAmount": "124.75",
"providerNote": "<string>",
"LocalTimestamp": "2016-04-13T19:15:00",
"UTCtimestamp": "2016-04-14T04:15:00",
"chauffeur": {
"chauffeurId": "01-abc",
"firstName": "Joe",
"lastName": "Smith",
"email": "joe@limo1.com",
"phoneNumber": "212.222.2222",
"picURL": "<string>"
},
"vehicle": {
"vehicleId": "101",
"vehicleType": "sedan",
"make": "BMW",
"model": "750iL",
"year": "2017",
"vin": "<string>",
"mileage": "<string>",
"passengerCount": "3"
},
"fees": [
{
"code": "base",
"currency": "USD",
"description": "Base charges",
"fee": "75.00",
"percent": "<string>",
"reimbursable": "<string>",
"type": "EXPENSE"
}
]
}
headers = {
"token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {token: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
status: 'EN_ROUTE',
griddID: '4starlimo',
resNo: '756333',
requesterResNo: '12343',
transactionId: 'c1df1d28-0608-4df7-b268-cc68ba175ed6',
totalAmount: '124.75',
providerNote: '<string>',
LocalTimestamp: '2016-04-13T19:15:00',
UTCtimestamp: '2016-04-14T04:15:00',
chauffeur: {
chauffeurId: '01-abc',
firstName: 'Joe',
lastName: 'Smith',
email: 'joe@limo1.com',
phoneNumber: '212.222.2222',
picURL: '<string>'
},
vehicle: {
vehicleId: '101',
vehicleType: 'sedan',
make: 'BMW',
model: '750iL',
year: '2017',
vin: '<string>',
mileage: '<string>',
passengerCount: '3'
},
fees: [
{
code: 'base',
currency: 'USD',
description: 'Base charges',
fee: '75.00',
percent: '<string>',
reimbursable: '<string>',
type: 'EXPENSE'
}
]
})
};
fetch('https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'status' => 'EN_ROUTE',
'griddID' => '4starlimo',
'resNo' => '756333',
'requesterResNo' => '12343',
'transactionId' => 'c1df1d28-0608-4df7-b268-cc68ba175ed6',
'totalAmount' => '124.75',
'providerNote' => '<string>',
'LocalTimestamp' => '2016-04-13T19:15:00',
'UTCtimestamp' => '2016-04-14T04:15:00',
'chauffeur' => [
'chauffeurId' => '01-abc',
'firstName' => 'Joe',
'lastName' => 'Smith',
'email' => 'joe@limo1.com',
'phoneNumber' => '212.222.2222',
'picURL' => '<string>'
],
'vehicle' => [
'vehicleId' => '101',
'vehicleType' => 'sedan',
'make' => 'BMW',
'model' => '750iL',
'year' => '2017',
'vin' => '<string>',
'mileage' => '<string>',
'passengerCount' => '3'
],
'fees' => [
[
'code' => 'base',
'currency' => 'USD',
'description' => 'Base charges',
'fee' => '75.00',
'percent' => '<string>',
'reimbursable' => '<string>',
'type' => 'EXPENSE'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version}"
payload := strings.NewReader("{\n \"status\": \"EN_ROUTE\",\n \"griddID\": \"4starlimo\",\n \"resNo\": \"756333\",\n \"requesterResNo\": \"12343\",\n \"transactionId\": \"c1df1d28-0608-4df7-b268-cc68ba175ed6\",\n \"totalAmount\": \"124.75\",\n \"providerNote\": \"<string>\",\n \"LocalTimestamp\": \"2016-04-13T19:15:00\",\n \"UTCtimestamp\": \"2016-04-14T04:15:00\",\n \"chauffeur\": {\n \"chauffeurId\": \"01-abc\",\n \"firstName\": \"Joe\",\n \"lastName\": \"Smith\",\n \"email\": \"joe@limo1.com\",\n \"phoneNumber\": \"212.222.2222\",\n \"picURL\": \"<string>\"\n },\n \"vehicle\": {\n \"vehicleId\": \"101\",\n \"vehicleType\": \"sedan\",\n \"make\": \"BMW\",\n \"model\": \"750iL\",\n \"year\": \"2017\",\n \"vin\": \"<string>\",\n \"mileage\": \"<string>\",\n \"passengerCount\": \"3\"\n },\n \"fees\": [\n {\n \"code\": \"base\",\n \"currency\": \"USD\",\n \"description\": \"Base charges\",\n \"fee\": \"75.00\",\n \"percent\": \"<string>\",\n \"reimbursable\": \"<string>\",\n \"type\": \"EXPENSE\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version}")
.header("token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"status\": \"EN_ROUTE\",\n \"griddID\": \"4starlimo\",\n \"resNo\": \"756333\",\n \"requesterResNo\": \"12343\",\n \"transactionId\": \"c1df1d28-0608-4df7-b268-cc68ba175ed6\",\n \"totalAmount\": \"124.75\",\n \"providerNote\": \"<string>\",\n \"LocalTimestamp\": \"2016-04-13T19:15:00\",\n \"UTCtimestamp\": \"2016-04-14T04:15:00\",\n \"chauffeur\": {\n \"chauffeurId\": \"01-abc\",\n \"firstName\": \"Joe\",\n \"lastName\": \"Smith\",\n \"email\": \"joe@limo1.com\",\n \"phoneNumber\": \"212.222.2222\",\n \"picURL\": \"<string>\"\n },\n \"vehicle\": {\n \"vehicleId\": \"101\",\n \"vehicleType\": \"sedan\",\n \"make\": \"BMW\",\n \"model\": \"750iL\",\n \"year\": \"2017\",\n \"vin\": \"<string>\",\n \"mileage\": \"<string>\",\n \"passengerCount\": \"3\"\n },\n \"fees\": [\n {\n \"code\": \"base\",\n \"currency\": \"USD\",\n \"description\": \"Base charges\",\n \"fee\": \"75.00\",\n \"percent\": \"<string>\",\n \"reimbursable\": \"<string>\",\n \"type\": \"EXPENSE\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"status\": \"EN_ROUTE\",\n \"griddID\": \"4starlimo\",\n \"resNo\": \"756333\",\n \"requesterResNo\": \"12343\",\n \"transactionId\": \"c1df1d28-0608-4df7-b268-cc68ba175ed6\",\n \"totalAmount\": \"124.75\",\n \"providerNote\": \"<string>\",\n \"LocalTimestamp\": \"2016-04-13T19:15:00\",\n \"UTCtimestamp\": \"2016-04-14T04:15:00\",\n \"chauffeur\": {\n \"chauffeurId\": \"01-abc\",\n \"firstName\": \"Joe\",\n \"lastName\": \"Smith\",\n \"email\": \"joe@limo1.com\",\n \"phoneNumber\": \"212.222.2222\",\n \"picURL\": \"<string>\"\n },\n \"vehicle\": {\n \"vehicleId\": \"101\",\n \"vehicleType\": \"sedan\",\n \"make\": \"BMW\",\n \"model\": \"750iL\",\n \"year\": \"2017\",\n \"vin\": \"<string>\",\n \"mileage\": \"<string>\",\n \"passengerCount\": \"3\"\n },\n \"fees\": [\n {\n \"code\": \"base\",\n \"currency\": \"USD\",\n \"description\": \"Base charges\",\n \"fee\": \"75.00\",\n \"percent\": \"<string>\",\n \"reimbursable\": \"<string>\",\n \"type\": \"EXPENSE\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body"OK"Provider Updates
Update Status by Transaction ID
Provider systems push status changes to GNet by Transaction ID
POST
/
providerUpdateStatusByTransactionId
/
{TRANSACTIONID}
/
{version}
Update status by Transaction ID
curl --request POST \
--url https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version} \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"status": "EN_ROUTE",
"griddID": "4starlimo",
"resNo": "756333",
"requesterResNo": "12343",
"transactionId": "c1df1d28-0608-4df7-b268-cc68ba175ed6",
"totalAmount": "124.75",
"providerNote": "<string>",
"LocalTimestamp": "2016-04-13T19:15:00",
"UTCtimestamp": "2016-04-14T04:15:00",
"chauffeur": {
"chauffeurId": "01-abc",
"firstName": "Joe",
"lastName": "Smith",
"email": "joe@limo1.com",
"phoneNumber": "212.222.2222",
"picURL": "<string>"
},
"vehicle": {
"vehicleId": "101",
"vehicleType": "sedan",
"make": "BMW",
"model": "750iL",
"year": "2017",
"vin": "<string>",
"mileage": "<string>",
"passengerCount": "3"
},
"fees": [
{
"code": "base",
"currency": "USD",
"description": "Base charges",
"fee": "75.00",
"percent": "<string>",
"reimbursable": "<string>",
"type": "EXPENSE"
}
]
}
'import requests
url = "https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version}"
payload = {
"status": "EN_ROUTE",
"griddID": "4starlimo",
"resNo": "756333",
"requesterResNo": "12343",
"transactionId": "c1df1d28-0608-4df7-b268-cc68ba175ed6",
"totalAmount": "124.75",
"providerNote": "<string>",
"LocalTimestamp": "2016-04-13T19:15:00",
"UTCtimestamp": "2016-04-14T04:15:00",
"chauffeur": {
"chauffeurId": "01-abc",
"firstName": "Joe",
"lastName": "Smith",
"email": "joe@limo1.com",
"phoneNumber": "212.222.2222",
"picURL": "<string>"
},
"vehicle": {
"vehicleId": "101",
"vehicleType": "sedan",
"make": "BMW",
"model": "750iL",
"year": "2017",
"vin": "<string>",
"mileage": "<string>",
"passengerCount": "3"
},
"fees": [
{
"code": "base",
"currency": "USD",
"description": "Base charges",
"fee": "75.00",
"percent": "<string>",
"reimbursable": "<string>",
"type": "EXPENSE"
}
]
}
headers = {
"token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {token: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
status: 'EN_ROUTE',
griddID: '4starlimo',
resNo: '756333',
requesterResNo: '12343',
transactionId: 'c1df1d28-0608-4df7-b268-cc68ba175ed6',
totalAmount: '124.75',
providerNote: '<string>',
LocalTimestamp: '2016-04-13T19:15:00',
UTCtimestamp: '2016-04-14T04:15:00',
chauffeur: {
chauffeurId: '01-abc',
firstName: 'Joe',
lastName: 'Smith',
email: 'joe@limo1.com',
phoneNumber: '212.222.2222',
picURL: '<string>'
},
vehicle: {
vehicleId: '101',
vehicleType: 'sedan',
make: 'BMW',
model: '750iL',
year: '2017',
vin: '<string>',
mileage: '<string>',
passengerCount: '3'
},
fees: [
{
code: 'base',
currency: 'USD',
description: 'Base charges',
fee: '75.00',
percent: '<string>',
reimbursable: '<string>',
type: 'EXPENSE'
}
]
})
};
fetch('https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'status' => 'EN_ROUTE',
'griddID' => '4starlimo',
'resNo' => '756333',
'requesterResNo' => '12343',
'transactionId' => 'c1df1d28-0608-4df7-b268-cc68ba175ed6',
'totalAmount' => '124.75',
'providerNote' => '<string>',
'LocalTimestamp' => '2016-04-13T19:15:00',
'UTCtimestamp' => '2016-04-14T04:15:00',
'chauffeur' => [
'chauffeurId' => '01-abc',
'firstName' => 'Joe',
'lastName' => 'Smith',
'email' => 'joe@limo1.com',
'phoneNumber' => '212.222.2222',
'picURL' => '<string>'
],
'vehicle' => [
'vehicleId' => '101',
'vehicleType' => 'sedan',
'make' => 'BMW',
'model' => '750iL',
'year' => '2017',
'vin' => '<string>',
'mileage' => '<string>',
'passengerCount' => '3'
],
'fees' => [
[
'code' => 'base',
'currency' => 'USD',
'description' => 'Base charges',
'fee' => '75.00',
'percent' => '<string>',
'reimbursable' => '<string>',
'type' => 'EXPENSE'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version}"
payload := strings.NewReader("{\n \"status\": \"EN_ROUTE\",\n \"griddID\": \"4starlimo\",\n \"resNo\": \"756333\",\n \"requesterResNo\": \"12343\",\n \"transactionId\": \"c1df1d28-0608-4df7-b268-cc68ba175ed6\",\n \"totalAmount\": \"124.75\",\n \"providerNote\": \"<string>\",\n \"LocalTimestamp\": \"2016-04-13T19:15:00\",\n \"UTCtimestamp\": \"2016-04-14T04:15:00\",\n \"chauffeur\": {\n \"chauffeurId\": \"01-abc\",\n \"firstName\": \"Joe\",\n \"lastName\": \"Smith\",\n \"email\": \"joe@limo1.com\",\n \"phoneNumber\": \"212.222.2222\",\n \"picURL\": \"<string>\"\n },\n \"vehicle\": {\n \"vehicleId\": \"101\",\n \"vehicleType\": \"sedan\",\n \"make\": \"BMW\",\n \"model\": \"750iL\",\n \"year\": \"2017\",\n \"vin\": \"<string>\",\n \"mileage\": \"<string>\",\n \"passengerCount\": \"3\"\n },\n \"fees\": [\n {\n \"code\": \"base\",\n \"currency\": \"USD\",\n \"description\": \"Base charges\",\n \"fee\": \"75.00\",\n \"percent\": \"<string>\",\n \"reimbursable\": \"<string>\",\n \"type\": \"EXPENSE\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version}")
.header("token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"status\": \"EN_ROUTE\",\n \"griddID\": \"4starlimo\",\n \"resNo\": \"756333\",\n \"requesterResNo\": \"12343\",\n \"transactionId\": \"c1df1d28-0608-4df7-b268-cc68ba175ed6\",\n \"totalAmount\": \"124.75\",\n \"providerNote\": \"<string>\",\n \"LocalTimestamp\": \"2016-04-13T19:15:00\",\n \"UTCtimestamp\": \"2016-04-14T04:15:00\",\n \"chauffeur\": {\n \"chauffeurId\": \"01-abc\",\n \"firstName\": \"Joe\",\n \"lastName\": \"Smith\",\n \"email\": \"joe@limo1.com\",\n \"phoneNumber\": \"212.222.2222\",\n \"picURL\": \"<string>\"\n },\n \"vehicle\": {\n \"vehicleId\": \"101\",\n \"vehicleType\": \"sedan\",\n \"make\": \"BMW\",\n \"model\": \"750iL\",\n \"year\": \"2017\",\n \"vin\": \"<string>\",\n \"mileage\": \"<string>\",\n \"passengerCount\": \"3\"\n },\n \"fees\": [\n {\n \"code\": \"base\",\n \"currency\": \"USD\",\n \"description\": \"Base charges\",\n \"fee\": \"75.00\",\n \"percent\": \"<string>\",\n \"reimbursable\": \"<string>\",\n \"type\": \"EXPENSE\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{TRANSACTIONID}/{version}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"status\": \"EN_ROUTE\",\n \"griddID\": \"4starlimo\",\n \"resNo\": \"756333\",\n \"requesterResNo\": \"12343\",\n \"transactionId\": \"c1df1d28-0608-4df7-b268-cc68ba175ed6\",\n \"totalAmount\": \"124.75\",\n \"providerNote\": \"<string>\",\n \"LocalTimestamp\": \"2016-04-13T19:15:00\",\n \"UTCtimestamp\": \"2016-04-14T04:15:00\",\n \"chauffeur\": {\n \"chauffeurId\": \"01-abc\",\n \"firstName\": \"Joe\",\n \"lastName\": \"Smith\",\n \"email\": \"joe@limo1.com\",\n \"phoneNumber\": \"212.222.2222\",\n \"picURL\": \"<string>\"\n },\n \"vehicle\": {\n \"vehicleId\": \"101\",\n \"vehicleType\": \"sedan\",\n \"make\": \"BMW\",\n \"model\": \"750iL\",\n \"year\": \"2017\",\n \"vin\": \"<string>\",\n \"mileage\": \"<string>\",\n \"passengerCount\": \"3\"\n },\n \"fees\": [\n {\n \"code\": \"base\",\n \"currency\": \"USD\",\n \"description\": \"Base charges\",\n \"fee\": \"75.00\",\n \"percent\": \"<string>\",\n \"reimbursable\": \"<string>\",\n \"type\": \"EXPENSE\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body"OK"Accepts the same payload as Update Status by Reservation #, keyed by Transaction ID instead. See Status Codes for the full list of valid status values.
Authorizations
Security token obtained from getToken2.
Path Parameters
Transaction ID for the trip.
API version. Must be set to V1.
Available options:
V1 Body
application/json
Status update pushed by the provider system. Include chauffeur, vehicle, fees, and total when they change.
New status code. See the Status Codes reference.
Example:
"EN_ROUTE"
GRiDD ID of the provider.
Example:
"4starlimo"
Provider reservation #.
Example:
"756333"
Requester reservation #.
Example:
"12343"
Example:
"c1df1d28-0608-4df7-b268-cc68ba175ed6"
Example:
"124.75"
Free-form notes from the provider on this trip.
Example:
"2016-04-13T19:15:00"
Example:
"2016-04-14T04:15:00"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
Update accepted
The response is of type string.
⌘I