G
Not authenticated — log in first
VendorProducts

Get Product

Get Product — vendor REST API endpoint.

GET/vendor/products/:idVendor bearer token required

Get Product

Retrieve a single product by ID.

What this means in plain English

Returns full product details including variants, images, and inventory for your vendor.

When to use this

  • Fetching product details for an integration sync.

Path parameters

NameTypeRequiredDescription
idstring (UUID)YesProduct ID.

Headers

NameTypeRequiredDescription
X-Vendor-Idstring (UUID)YesUUID of the vendor context. Required for vendor-scoped endpoints when your account has multiple vendor memberships. Use the vendor.id from the login response.

Request example

curl -X GET 'http://localhost:8080/api/v1/vendor/products/550e8400-e29b-41d4-a716-446655440020' \
  -H 'X-Vendor-Id: 550e8400-e29b-41d4-a716-446655440010'

Response examples

200Success
{
  "id": "550e8400-e29b-41d4-a716-446655440020",
  "name": "Widget Pro",
  "sku": "WIDGET-001",
  "status": "ACTIVE",
  "vendorId": "550e8400-e29b-41d4-a716-446655440010"
}

Status codes

200

OK

Request succeeded.

401

Unauthorized

Missing or invalid bearer token.

403

Forbidden

Insufficient permissions for this action.

400

Bad Request

Validation failed or invalid parameters.

404

Not Found

Resource not found.

500

Internal Server Error

Unexpected server error.

403

Forbidden

Invalid X-Vendor-Id, no vendor membership, or insufficient vendor role (requires OWNER, ADMIN, or EDITOR for write operations).

Try it

Uses your saved session from login. Edit values and send a live request, or copy the cURL command.