Skip to main content

​
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. Note: The requester and provider should establish a partnership before conducting business with each other to ensure proper integration and service delivery. Important: For all API calls, you need to get the token using your API Gateway user.

​
Getting Started

​
Check out YouTube Videos

Visit our YouTube playlist for detailed integration tutorials and walkthroughs.

​
Sign Up to GNet

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

​
Farm In (Receiving Reservations)

Create a REST Endpoint 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 Updates

Send reservation updates such as confirmations and status changes (including ACCEPT, ASSIGN, EN_ROUTE, AT_LOCATION) to this endpoint: Endpoint: https://api.grdd.net/Platform.svc/providerUpdateStatusByTransactionId/{transactionId}/v1 For detailed documentation, see: Provider Update Status API

​
GPS Location Updates

Update current location of drivers using this API: Endpoint: POST https://location.grdd.net/api/GGPS.svc/saveGPScache Include the token in the header.

​
Sample Payload

{
   "chfName": "Alex Jones",
   "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>

​
Step 3: Register Callback Webhook

Register a callback webhook to receive reservation updates from providers. Your endpoint should:
  • 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:

​
Testing Steps:

  1. Log in to GBOOK
  2. Go to BOOK menu
  3. Select <griddid> from the affiliate dropdown box
  4. Fill in trip details and click BOOK
  5. 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:

  1. Import the collection
  2. Set environment variables:
    • token
    • requesterId
    • providerId
  3. 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
}

​
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.
⌘I