> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grdd.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Partners

> Retrieve a list of partners for a specific GNet ID

## 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**:
  ```http theme={null}
  Authorization: Bearer <accessToken>
  ```
* **Legacy Token**:
  ```http theme={null}
  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**

| Parameter | Type   | Description                                                                            |
| :-------- | :----- | :------------------------------------------------------------------------------------- |
| `griddid` | string | **(Required)** The unique GNet ID of the operator whose partners you want to retrieve. |
| `format`  | string | **(Optional)** JSON response format. Options: `full` (default) or `short`.             |

***

### **Response**

#### **Full Format** (`format=full`)

```json theme={null}
{
  "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`)

```json theme={null}
{
  "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.