Connect to Premium Apparel: API and AI assistants

Connect your own website, ordering system or AI assistant straight to Premium Apparel. See your prices and our stock in real time, and place and track orders, without logging in to this site.

Jump to: Connect your website or system (API) · Connect your AI assistant (MCP)

Step 1: get your API key

Both options use the same API key. Email Customer Service with your business name and customer ID, and tell us whether you need to place orders or only read prices and stock (we can issue a read-only key).

We send your key through a secure link that can only be opened once, never in the email itself. Treat it like a password: anyone holding it can see your prices and, unless it's read-only, place orders on your account. If you change staff or think it's been shared, ask us to revoke it.

Connect your website or system (API)

First, get your API key. The API and AI assistants use the same key. We send it through a secure link that can only be opened once.

Request your API key

For developers. The Premium Apparel API is a standard REST API (JSON over HTTPS) for keeping your website or system in sync with our range, stock and your prices, and for sending orders straight to us.

What you can do

Endpoint What it does
GET /v1/products Our product catalogue (styles, colours, sizes, images and details) with your own trade pricing
GET /v1/stock Current stock for every size-level SKU, to keep stock on your site up to date
GET /v1/prices Your price for every size-level SKU, ex GST
POST /v1/orders Place a sales order
GET /v1/orders Find an order by your own reference, such as your PO number
GET /v1/orders/{id} An order's details and progress
PATCH /v1/orders/{our_ref} Amend an order's details, such as the delivery address or comments

How to connect

  1. Use https://api.premiumapparel.co.nz for New Zealand or https://api.premiumapparel.com.au for Australia. The address you use sets the region.
  2. Send your API key with every request in the Authorization header: Authorization: Bearer YOUR_API_KEY
  3. Try a first call, for example stock for one style:
    curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.premiumapparel.co.nz/v1/stock?style=5000"
  4. Or open the API docs, click Authorize, paste your key, and try any endpoint from the page itself.

Premium Apparel API docs home page, showing the Authorize button and the Orders and Products endpoints
The API docs: click Authorize (top right of the endpoint list) and paste your key to try calls live.

Good to know

  • Prices are ex GST, both in and out.
  • Stay in sync with since: poll /v1/stock and /v1/prices regularly, and /v1/products?since= less often, to pick up only what has changed.
  • Out of stock items stay in the feed with a stock of 0. Items we stop selling drop out of the feed and are listed as removed.
  • There is no rate limit today. Any change will be announced on the changelog first.
  • There is no test environment, so start with read calls. Any order you create is a real order.

Developer docs: API reference · Integration FAQ · Error reference · Changelog · OpenAPI specification

Connect your AI assistant (MCP)

First, get your API key. Your AI assistant connects with the same key as the API. We send it through a secure link that can only be opened once.

Request your API key

Ask ChatGPT, Claude, Grok or another AI assistant about our stock and your prices, or have it place and track orders for you, with no code to write. It connects through the Model Context Protocol (MCP) using the same API key, and sees exactly what your key allows, nothing more.

What your assistant can do

Tool What it does Try asking
list_products Finds products, with your pricing “What colours does the 5000 Heavy Cotton Tee come in, and what's my price?”
get_stock Checks stock by style, colour and size “How many 64000 in Black, size L, are in stock?”
get_prices Your price for each size “What do I pay for a UCT180 in Navy, 2XL?”
create_order Places a sales order “Order 20 of the 5000 in Black, 5 each of S to XL, our PO 1234.”
find_order_by_reference Finds an order by your PO or reference “Where's our order for PO 1234?”
get_order Shows an order's details and progress “What's on order 0648864?”
update_order Changes an order's details, such as the delivery address or a comment “Add a note to PO 1234: please deliver after 10am.”
add_order_lines and set_order_lines Add lines to an order, or replace its lines (needs the line-amendment permission; ask us) “Add 10 of the 18500 Hoodie in Navy, size L, to PO 1234.”
update_products Updates product details (product-management accounts only) Not needed by most customers

Claude (web or desktop app)

  1. Go to Settings → Connectors → Add custom connector.
  2. Name it Premium Apparel and enter the address https://api.premiumapparel.co.nz/mcp (Australian accounts: https://api.premiumapparel.com.au/mcp). Leave any advanced or OAuth fields blank.
  3. Click Connect. A Premium Apparel page opens in your browser: paste your API key there to finish.
  4. In a chat, make sure the Premium Apparel connector is switched on, then ask away.

ChatGPT

  1. Go to Settings → Connectors, turn on developer mode, then add a new connector.
  2. Name it Premium Apparel and enter https://api.premiumapparel.co.nz/mcp (Australian accounts: https://api.premiumapparel.com.au/mcp). Leave any advanced or OAuth client fields blank.
  3. When the Premium Apparel page opens in your browser, paste your API key to finish.
  4. Choose the Premium Apparel connector in your chat. If you can't see a connectors or developer mode option, check that your ChatGPT plan supports custom connectors.

Grok

  1. Go to grok.com/connectors (or Plugins → Connectors in the Grok sidebar), click New Connector, then choose Custom.
  2. Name it Premium Apparel, enter the Server URL https://api.premiumapparel.co.nz/mcp (Australian accounts: https://api.premiumapparel.com.au/mcp), then click Add Connector.
  3. A Premium Apparel window opens: paste your API key there to finish. If nothing opens, allow pop-ups for grok.com and add the connector again.
  4. Switch the Premium Apparel connector on in your chat. Custom connectors need a paid Grok plan. On Grok Business, an admin adds the connector first in the xAI console under Grok Business → Connectors, then each person connects with their own key.

Claude Code and other command-line tools

Tools that let you set a header can connect directly with your key:

claude mcp add --transport http premium-apparel \
  https://api.premiumapparel.co.nz/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Any other assistant that supports remote MCP servers over HTTP can connect with the same address.

Premium Apparel MCP guide, showing the connection address and where to add a custom connector in Claude and ChatGPT
Our MCP guide: the connection address for each region, and where to add it in Claude and ChatGPT.

Keeping it safe

  • Your assistant never sees your API key. It gets a limited connection that only works for the tools above.
  • Orders it places are real orders. Check what it's about to do before you let it go ahead, just as you would with a staff member.
  • Revoking your key disconnects every assistant using it straight away. Email us if you need that.
  • Ask about specific styles. Very large catalogue requests are capped, so “stock of the 5000 in Black” works better than “everything you sell”.

For developers: the MCP guide has the full connection detail and every tool's fields.

Questions, or need your key? Email Customer Service.