Get seller

Credentials

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

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

Node.js

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

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

$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 
{
  "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 
{
  "statusCode": 401,
  "message": "Unauthorized"
}