Skip to main content

​
Get Partners API

The Get Partners API allows you to retrieve the list of partners associated with a specific GNet ID (griddid). This is useful for Gateways or users who manage multiple operators or need to sync partner data.

​
Endpoint

GET https://core.grdd.net/api/partner/[griddid]?format={format}

​
Headers

Include one of the following headers for authentication:
  • OAuth Bearer Token: 
    Authorization: Bearer <accessToken>
  • Legacy Token: 
    token: <token>
[NOTE] If the token belongs to a Gateway user, you can query the partners of different [griddid] values, provided they are listed under your platform. Example: A Fasttrak Gateway token can retrieve partners for any operator using Fasttrak technology (e.g., “xyz limo”).

​
Parameters

ParameterTypeDescription
griddidstring(Required) The unique GNet ID of the operator whose partners you want to retrieve.
formatstring(Optional) JSON response format. Options: full (default) or short.

​
Response

​
Full Format (format=full)

{
  "success": true,
  "data": [
    {
      "partnerid": "2slimo",
      "notes": "",
      "accountno": "",
      "fleetSize": "0",
      "contactName": "",
      "farmGroupId": 171,
      "contactPhone": "",
      "contactEmail": "",
      "shareMyfleet": false,
      "contractedFlg": false,
      "primaryAffiliate": false,
      "allowQuotes": false,
      "allowFarmhouseAccess": true,
      "city": "Mühlheim am Main",
      "name": "2S LimouERP Test",
      "logo_url": ""
    }
  ]
}

​
Short Format (format=short)

{
  "success": true,
  "data": [
    {
      "partnerid": "2slimo"
    }
  ]
}

​
Error Handling

Ensure you handle potential errors, such as:
  • 401 Unauthorized: If authentication headers are missing or invalid.
  • 403 Forbidden: If the token allows access but not to the requested griddid.
  • 404 Not Found: If the griddid does not exist.