GET/vendor/orders/:idVendor bearer token required

Get Order

Retrieve a single vendor suborder by ID.

What this means in plain English

Returns fulfillment details for your vendor suborder: amounts, addresses, line items, and a minimal buyer contact object (id, name, email). Secrets (password, TOTP), viewToken, parentOrder, and nested vendor are never returned.

When to use this

Fetching order details before creating a shipment.

Path parameters

Name	Type	Required	Description
id	string (UUID)	Yes	Suborder ID.

Request example

curl -X GET 'https://api.next.gcommerce.glass/api/v1/vendor/orders/550e8400-e29b-41d4-a716-446655440030'

Response examples

200Success

{
  "id": "550e8400-e29b-41d4-a716-446655440030",
  "orderNumber": "ORD-2026-0042-V1",
  "couponId": null,
  "paymentStatus": "COMPLETED",
  "parentOrderId": "550e8400-e29b-41d4-a716-446655440029",
  "vendorId": "550e8400-e29b-41d4-a716-446655440010",
  "userId": "550e8400-e29b-41d4-a716-446655440002",
  "isSuborder": true,
  "status": "CONFIRMED",
  "subtotal": "129.99",
  "tax": "10.40",
  "taxRate": "0.080000",
  "shipping": "9.60",
  "discount": "0.00",
  "total": "149.99",
  "shippingAddress": {
    "firstName": "John",
    "lastName": "Buyer",
    "address1": "456 Oak Ave",
    "city": "Dallas",
    "region": "TX",
    "postalCode": "75201",
    "country": "US"
  },
  "billingAddress": {
    "firstName": "John",
    "lastName": "Buyer",
    "address1": "456 Oak Ave",
    "city": "Dallas",
    "region": "TX",
    "postalCode": "75201",
    "country": "US"
  },
  "poNumber": "PO-7788",
  "notes": null,
  "additionalRecipientEmails": [],
  "createdAt": "2026-06-10T16:45:00.000Z",
  "updatedAt": "2026-06-10T16:45:00.000Z",
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440032",
      "orderId": "550e8400-e29b-41d4-a716-446655440029",
      "suborderId": "550e8400-e29b-41d4-a716-446655440030",
      "productVariantId": "550e8400-e29b-41d4-a716-446655440021",
      "productName": "Widget Pro",
      "variantName": "Default",
      "quantity": 2,
      "price": "29.99",
      "subtotal": "59.98",
      "imageUrl": "https://api.next.gcommerce.glass/assets/products/images/550e8400-e29b-41d4-a716-446655440022",
      "createdAt": "2026-06-10T16:45:00.000Z"
    }
  ],
  "buyer": {
    "id": "550e8400-e29b-41d4-a716-446655440002",
    "firstName": "John",
    "lastName": "Buyer",
    "email": "john.buyer@example.com"
  }
}

Status codes

200

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.

429

Too Many Requests

Global rate limit exceeded (10,000 requests per 10 minutes per IP).

500

Internal Server Error

Unexpected server error.

403

Forbidden

No vendor membership, or insufficient vendor role (requires OWNER, ADMIN, or EDITOR for write operations).

`buyer` is a safe contact subset only (`id`, `firstName`, `lastName`, `email`). Never expect `password`, `totpSecret`, or other user credentials in order responses.

Receipt `viewToken`, nested `vendor`, and `parentOrder` are omitted from vendor order responses.

`items[].imageUrl` is an absolute public asset URL (`{API_ORIGIN}/assets/…`) when a product image exists; otherwise `null`. See [Media URLs](/docs/v1/vendor#media-urls-images--documents).

Try it

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

Bearer tokenid *