Skip to main content
GET
/
users
/
{userId}
Get User
curl --request GET \
  --url https://staging-api.puppetvendors.com/users/{userId} \
  --header 'x-access-token: <api-key>'
import requests

url = "https://staging-api.puppetvendors.com/users/{userId}"

headers = {"x-access-token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'x-access-token': '<api-key>'}};

fetch('https://staging-api.puppetvendors.com/users/{userId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://staging-api.puppetvendors.com/users/{userId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-access-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://staging-api.puppetvendors.com/users/{userId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-access-token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://staging-api.puppetvendors.com/users/{userId}")
  .header("x-access-token", "<api-key>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://staging-api.puppetvendors.com/users/{userId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-access-token"] = '<api-key>'

response = http.request(request)
puts response.read_body
V2 Preview — This endpoint is part of the V2 API preview. Breaking changes may occur.

Overview

Retrieve a single vendor portal user. Vendor tokens are scoped to users belonging to the same vendor. Merchant tokens may read any user on the shop.

Path Parameters

userId
string
required
User ObjectId.

Response

200
{
  "success": true,
  "data": {
    "_id": "507f1f77bcf86cd799439030",
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "jane@example.com",
    "vendorId": "507f1f77bcf86cd799439012",
    "approved": true,
    "lastLogin": "2026-04-14T10:05:00Z",
    "createdAt": "2025-09-01T12:00:00Z"
  }
}

Example

curl -X GET "https://staging-api.puppetvendors.com/users/507f1f77bcf86cd799439030" \
  -H "x-access-token: YOUR_VENDOR_JWT"