# Get seller

Building with an AI agent? Start at https://docs.payme.io/agents.md

- Sandbox: your partner domain on the Keep sandbox: `GET https://<partner_domain>.keep.co.il/api/public/sellers/{sellerId}`
- Production: your partner domain: `GET https://<partner_domain>.keep.co.il/api/public/sellers/{sellerId}`

## Credentials

- Header `Authorization: Bearer <token>`

Retrieve seller information by Keep seller UUID or by MPL. Returns seller details including business information and timestamps.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `sellerId` | path | string | yes | Seller UUID or MPL ID |

## Code samples

### curl

```bash
curl -X GET 'https://<partner_domain>.keep.co.il/api/public/sellers/<sellerId>' \
  -H 'Authorization: Bearer <YOUR_TOKEN>'
```

### Node.js

```javascript
const response = await fetch("https://<partner_domain>.keep.co.il/api/public/sellers/<sellerId>", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <YOUR_TOKEN>",
  },
});

console.log(await response.text());
```

### Python

```python
import requests

response = requests.get(
    "https://<partner_domain>.keep.co.il/api/public/sellers/<sellerId>",
    headers={
        "Authorization": "Bearer <YOUR_TOKEN>",
    },
)

print(response.text)
```

### PHP

```php
<?php

$ch = curl_init('https://<partner_domain>.keep.co.il/api/public/sellers/<sellerId>');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer <YOUR_TOKEN>',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
```

## Responses

### 200 — Seller retrieved successfully. When no seller matches, `payload` is null. (success)

| Field | Type | Description |
| --- | --- | --- |
| `payload` | object |  |
| `payload.id` | string | Seller UUID |
| `payload.firstName` | string | Seller's first name |
| `payload.lastName` | string | Seller's last name |
| `payload.email` | string | Primary email address |
| `payload.contactEmail` | string | Business contact email |
| `payload.phone` | string | Phone number |
| `payload.businessName` | string | Legal business name |
| `payload.businessType` | integer | Israeli business type. - `0` Not sure (לא ידוע) - `1` Osek Murshe, sole proprietorship (עוסק מורשה) - `2` Osek Patur, exempt small business (עוסק פטור) - `3` Incorporated company (חברה בע"מ) - `4` Partnership (שותפות) - `6` Non-profit (עמותה) - `7` Limited partnership (שותפות מוגבלת) - `8` Publicly traded company (חברה ציבורית) - `9` Shared cooperative (אגודה שיתופית) - `10` Public benefit company (חברה לתועלת הציבור) |
| `payload.businessNumber` | string | Israeli business registration number |
| `payload.socialId` | string | Israeli ID number |
| `payload.createdAt` | string | Account creation timestamp |
| `payload.updatedAt` | string | Last update timestamp |
| `payload.sellerStatus` | integer | `-1` new, `0` closed, `1` active |
| `payload.industryClassification` | integer |  |

```json
{
  "payload": {
    "id": "97bdce55-b2a2-450d-8d29-1dcf6bbcc419",
    "firstName": "David",
    "lastName": "Cohen",
    "email": "david.cohen@example.com",
    "contactEmail": "seller@example.com",
    "phone": "0500000009",
    "businessName": "Cohen Electronics Ltd",
    "businessType": 1,
    "businessNumber": "330988015",
    "socialId": "123456782",
    "createdAt": "2026-01-22T09:19:54.264Z",
    "updatedAt": "2026-01-22T09:19:54.403Z"
  }
}
```

### 401 — Unauthorized (error)

| Field | Type | Description |
| --- | --- | --- |
| `statusCode` | integer |  |
| `message` | string |  |

```json
{
  "statusCode": 401,
  "message": "Unauthorized"
}
```