Overview

The GNet platform is an integration platform that connects ground transportation companies, dispatch/reservation systems, and other custom integrations. Members of GNet can send (farm-out) and/or receive (farm-in) reservations. In this process, the sending party (also known as the requester) and the receiving party (the provider) are key players in ensuring smooth reservation transactions.

Notes:

The requester and provider should establish a partnership in GNet Connect before conducting business with each other to ensure proper integration and service delivery.
For all API calls, you need to get the token using your API Gateway user.
Visit our YouTube playlist for detailed integration tutorials and walkthroughs.
For API reference: GNet Platform API.
For legacy Apiary reference: GNet API on Apiary

Interactive Setup Wizard

Prefer a guided experience? Try our interactive step-by-step wizard to see exactly how to connect to the GNet platform quickly and easily.

Authentication

Platform API requests (e.g., sendTrip, providerUpdateStatusByResNo) require a token header obtained from getToken2.
Your inbound Farm In endpoint should be protected (e.g., Basic Authentication using your issued API key/secret) and must accept JSON.

If you haven’t already, please complete the Sign Up page.

Visit and sign up: https://connect.grdd.net/sign-up
The GNet team will review and approve your account
API credentials will be provided upon approval

Farm In (Receiving Reservations)

Please ask your technical team to create a webservice REST Endpoint (i.e. https://api.example.com/api/gnet-farmin) to accept POST requests with the following specifications:

Request Format

Method: POST
Headers:
- content-type: application/json
- Authorization: basic authentication (api_key/api_secret)
Body: JSON reservation payload (see sample)

Success Response

{
   "success": true,
   "reservationId": "11545-001",
   "totalAmount": "130.67",
   "transactionId": "<tx>"
}

Error Response

{
   "success": false,
   "message": "Unable to process the request due to XYZ.",
   "transactionId": "<tx>"
}

Reservation Status Updates

Send reservation updates such as confirmations and status changes (including CONFIRMED, ASSIGNED, EN_ROUTE, ON_LOCATION) to this endpoint: Endpoint: https://api.grdd.net/Platform.svc/providerUpdateStatusByResNo/{GRIDDID}/{RESNO}/{VERSION} Headers:

token: <from getToken2>
Content-Type: application/json

For example, to accept a booking request:

{
   "status": "CONFIRMED",
   "totalAmount": "120.00",
   "resNo": "<reservation_number>",
   "griddID": "<provider_griddid>"
}

For detailed documentation, see: Provider Update Status API and ( see other ASSIGNED payload example)

To see a list of all supported status codes, see Status Codes
To see a list of all supported vehicle types, see Vehicle Types

GPS Location Updates

Update current location of drivers using this API: Endpoint: POST https://location.grdd.net/api/GGPS.svc/saveGPScache Headers:

token: <from getToken2>
Content-Type: application/json

Sample Payload

{
   "chfName": "Jane Doe",
   "driverId": "123456",
   "griddid": "{{providerId}}",
   "internalBookingId": "123456",
   "latitude": "40.74",
   "locationDateTime": "2024-01-23T18:52:34",
   "longitude": "-100.56",
   "phoneNo": "+15555555555",
   "transactionId": "<>"
}

Example curl:

curl -X POST \
  "https://location.grdd.net/api/GGPS.svc/saveGPScache" \
  -H "token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "chfName": "Jane Doe",
    "driverId": "123456",
    "griddid": "{{providerId}}",
    "internalBookingId": "123456",
    "latitude": "40.74",
    "locationDateTime": "2024-01-23T18:52:34",
    "longitude": "-100.56",
    "phoneNo": "+15555555555",
    "transactionId": "<>"
  }'

Quote Requests

If the payload contains reservationType that is set to “QUOTE”:

Return the same payload structure as the Farm In success response
Include totalAmount in the response
You don’t need to create a reservation record in your database for quotes

Farm Out (Sending Reservations)

Step 1: Get Token

POST https://api.grdd.net/Platform.svc/getToken2
Content-Type: application/json

{
  "pw": "<password>",
  "uid": "<user_id>"
}

Step 2: Send Reservation

POST https://api.grdd.net/Platform.svc/sendTrip/v1
Headers:
  token: <from step 1>
  Content-Type: application/json

<your reservation json payload>

Example curl:

curl -X POST \
  "https://api.grdd.net/Platform.svc/sendTrip/v1" \
  -H "token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d @reservation.json

Step 3: Register Callback Webhook

Accept POST requests
Return 200 status code
Process reservation updates
A sample payload will be sent to your webhook URL

Step 4: Send Booking Updates or Cancel Requests

Updates

Include transactionId in payload and set affiliateReservation.action to “UPDATE”

Cancel Request

POST cancelTripByTransactionId/{TRANSACTIONID}/{version}

For detailed documentation, see: Cancel Trip API

Testing

GBOOK Testing Utility

To test incoming trips, log in to the GBOOK utility:

User: (use username/password provided by GNET)
URL: https://api.grdd.net/gbook

Testing Steps:

Log in to GBOOK
Go to BOOK menu
Select <griddid> from the affiliate dropdown box
Fill in trip details and click BOOK
You will receive the trip in your system

Note: Click “SHOW JSON” to see the exact payload structure you need to submit to GNet.

POSTMAN Collection

Download the complete collection: GNET.postman_collection.json

Setup:

Import the collection
Set environment variables:
- token
- requesterId
- providerId
Use the “Get Token” request first to obtain authentication token

Health Check

We use the Farm In Adapter GET endpoint for health checks. Expected Response:

Status code: 200
Body:

{
   "success": true
}

Example (assuming your Farm In endpoint is https://api.example.com/api/gnet-farmin):

curl -X GET "https://api.example.com/api/gnet-farmin" -i

Need Help?

Contact Support

Our support team is here to help you with integration questions and troubleshooting.

API Documentation

Complete API reference and detailed endpoint documentation.

Getting Started

Guides

Authentication

Reservations

Provider Updates

Tracking

Reference

Quick Start Guide

Overview

Interactive Setup Wizard

Authentication

Farm In (Receiving Reservations)

Request Format

Success Response

Error Response

Reservation Status Updates

GPS Location Updates

Sample Payload

Quote Requests

Farm Out (Sending Reservations)

Step 1: Get Token

Step 2: Send Reservation

Step 3: Register Callback Webhook

Step 4: Send Booking Updates or Cancel Requests

Updates

Cancel Request

Testing

GBOOK Testing Utility

Testing Steps:

POSTMAN Collection

Setup:

Health Check

Need Help?

Contact Support

API Documentation

​Overview

Interactive Setup Wizard

​Authentication

​Sign Up to GNet

​Farm In (Receiving Reservations)

​Request Format

​Success Response

​Error Response

​Reservation Status Updates

​GPS Location Updates

​Sample Payload

​Quote Requests

​Farm Out (Sending Reservations)

​Step 1: Get Token

​Step 2: Send Reservation

​Step 3: Register Callback Webhook

​Step 4: Send Booking Updates or Cancel Requests

​Updates

​Cancel Request

​Testing

​GBOOK Testing Utility

​Testing Steps:

​POSTMAN Collection

​Setup:

​Health Check

​Need Help?

Contact Support

API Documentation

Overview

Authentication

Sign Up to GNet

Farm In (Receiving Reservations)

Request Format

Success Response

Error Response

Reservation Status Updates

GPS Location Updates

Sample Payload

Quote Requests

Farm Out (Sending Reservations)

Step 1: Get Token

Step 2: Send Reservation

Step 3: Register Callback Webhook

Step 4: Send Booking Updates or Cancel Requests

Updates

Cancel Request

Testing

GBOOK Testing Utility

Testing Steps:

POSTMAN Collection

Setup:

Health Check

Need Help?