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

# Get partner

> Retrieve a specific partner's details, referral statistics, commissions, and referral links

## Endpoint

```
GET https://api.partnero.com/v1/partners/{id}
```

## Path parameters

| Parameter | Type   | Required | Description         |
| --------- | ------ | -------- | ------------------- |
| `id`      | string | Yes      | Partner's unique ID |

## Request

```bash cURL theme={null}
curl --location 'https://api.partnero.com/v1/partners/partner_123' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "email": "john.doe@partnero.com",
      "created_at": "2025-04-30T16:44:13.000000Z",
      "updated_at": "2025-04-30T16:44:13.000000Z",
      "name": "John",
      "id": "partner_123",
      "surname": "Doe",
      "tos": false,
      "approved": true,
      "status": "active",
      "referrals": {
        "clicks": 150,
        "signups": 12,
        "revenue": [
          {
            "currency": "USD",
            "amount": 1250.00
          }
        ],
        "sales_count": 8,
        "paid_accounts": 5
      },
      "commissions": {
        "paid": 375.00,
        "pending": [
          {
            "currency": "USD",
            "amount": 125.00
          }
        ],
        "not_paid": [
          {
            "currency": "USD",
            "amount": 50.00
          }
        ]
      },
      "custom_field_values": [],
      "custom_fields": [],
      "referrals_count": 12,
      "tags": [
        {
          "value": "premium"
        }
      ],
      "referral_link": "https://yourcompany.com?aff=ref_123",
      "referral_links": [
        "https://yourcompany.com?aff=ref_123"
      ]
    },
    "status": 1
  }
  ```
</ResponseExample>

### Response fields

<Accordion title="Partner details — data">
  | Field                 | Type    | Description                                                |
  | --------------------- | ------- | ---------------------------------------------------------- |
  | `id`                  | string  | Unique partner identifier                                  |
  | `email`               | string  | Partner's email address                                    |
  | `name`                | string  | Partner's first name                                       |
  | `surname`             | string  | Partner's last name                                        |
  | `status`              | string  | Partner status: `active`, `pending`, `archived`, `deleted` |
  | `approved`            | boolean | Whether the partner is approved                            |
  | `tos`                 | boolean | Whether the partner accepted terms of service              |
  | `custom_fields`       | array   | Custom signup field key-value pairs                        |
  | `custom_field_values` | array   | Custom field values (raw)                                  |
  | `referrals_count`     | integer | Total number of referred customers                         |
  | `tags`                | array   | Partner tags (each with a `value` key)                     |
  | `referral_link`       | string  | Primary referral link                                      |
  | `referral_links`      | array   | All referral links                                         |
  | `created_at`          | string  | ISO 8601 timestamp                                         |
  | `updated_at`          | string  | ISO 8601 timestamp                                         |
</Accordion>

<Accordion title="Referral statistics — data.referrals">
  | Field           | Type    | Description                                             |
  | --------------- | ------- | ------------------------------------------------------- |
  | `clicks`        | integer | Total referral link clicks                              |
  | `signups`       | integer | Total referred sign-ups                                 |
  | `revenue`       | array   | Revenue by currency (each with `currency` and `amount`) |
  | `sales_count`   | integer | Total sales count                                       |
  | `paid_accounts` | integer | Total paid accounts from referrals                      |
</Accordion>

<Accordion title="Commissions — data.commissions">
  | Field      | Type   | Description                     |
  | ---------- | ------ | ------------------------------- |
  | `paid`     | number | Total paid commissions          |
  | `pending`  | array  | Pending commissions by currency |
  | `not_paid` | array  | Unpaid commissions by currency  |
</Accordion>