Submit orders
Send orders with shipping details, Lynka SKUs and decoration data — embroidery, screen print, digital print or transfer — for Standard, print-on-demand and stock lines.
POST /ordersLynkaHub API · B2B integration
Submit decorated-apparel orders, track their status and shipment, and check live stock availability straight from your ERP, e-commerce platform or order management system. No manual uploads, no re-typing — one REST API for your orders with Lynka.
What the API covers
The LynkaHub API is built for distributors, resellers and brands that order branded apparel from Lynka regularly and want those orders to flow automatically.
Send orders with shipping details, Lynka SKUs and decoration data — embroidery, screen print, digital print or transfer — for Standard, print-on-demand and stock lines.
POST /ordersFollow every order from queue to shipment. Statuses tell you whether it was accepted, needs a correction or has shipped — with carrier tracking numbers.
GET /orders/{id}Download availability for the SKUs in your catalogue — stock in the Lynka warehouse and at the vendor — in full or incrementally, refreshed every 3 hours.
GET /availabilityIf a single decoration line is rejected, fix and resend just that line. The rest of the order keeps moving — no need to resubmit everything.
PUT …/decorations/{code}How it works
Orders are processed asynchronously: your system hands the order over in one call and checks the outcome in another.
Send us the public IP addresses you will call from. We allowlist them and issue your client code and API key.
A 202 response confirms the order is queued and returns a correlationId — store it.
Validation and delivery to production happen in the background. Poll the status — once every 15 minutes is enough.
When the order ships, its status changes to SHIPPED and the carrier tracking number is returned.
Endpoints
Six endpoints under /api/v1. Full field rules, response examples and error codes are in the documentation.
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /api/v1/health | Check that the API is reachable (no API key required) |
| POST | /api/v1/orders | Submit a new order with order lines and decoration data |
| GET | /api/v1/orders/{correlationId} | Status of a single submission, incl. errors and tracking numbers |
| GET | /api/v1/orders?orderNo=… | Full history of submissions under one order number |
| PUT | /api/v1/orders/{correlationId}/lines/{lineNo}/decorations/{externalDesignCode} | Replace a rejected decoration line with corrected data |
| GET | /api/v1/availability | Stock availability per Lynka SKU, paginated and filterable |
Example
Standard HTTPS requests with JSON bodies — any language or integration platform that can send HTTP requests can connect.
POST /api/v1/orders
X-Client-Code: YOUR_CLIENT_CODE
X-Api-Key: YOUR_API_KEY
Content-Type: application/json
{
"orderNo": "ORD-2026-00123",
"shipToName": "John Smith",
"shipToCountryCode": "PL",
// … remaining shipping fields
"orderLines": [
{
"lineNo": 10000,
"itemNo": "TBC/TU01T/001/3",
"quantity": 5,
"orderType": "Standard",
"designCode": "NZ02033-26-P00062",
"decorationLines": [
{ "externalDesignCode": "NZ02033-26-P00062", "decorationType": "Embroidery" }
]
}
]
}
// 202 Accepted
{ "correlationId": "f9d72f25-7e0d-4ddd-9256-4c7a3ad5dde0", "status": "NEW" }
GET /api/v1/orders/f9d72f25-7e0d-4ddd-9256-4c7a3ad5dde0
X-Client-Code: YOUR_CLIENT_CODE
X-Api-Key: YOUR_API_KEY
// 200 OK
{
"orderNo": "ORD-2026-00123",
"status": "SHIPPED",
"validationErrors": null,
"decorationErrors": null,
"trackingNumbers": "00340434161094042557"
}
GET /api/v1/availability?limit=1000&offset=0&onlyAvailable=true
X-Client-Code: YOUR_CLIENT_CODE
X-Api-Key: YOUR_API_KEY
// 200 OK
{
"total": 16269,
"items": [
{
"lynkaSKU": "XXX/00512/03",
"availabilityQtyLynka": "10.0000",
"availabilityQtyVend": "100.0000",
"lastModifiedDateTime": "2026-08-03T14:45:00Z"
}
]
}
Examples are shortened. The documentation lists every field, validation rule and error response.
Before you integrate
202 means “received”, not “valid”. Field errors are reported by the status endpoint.modifiedAfter.FAQ
The API is available to Lynka business customers — distributors, resellers, promotional agencies and brands — who want to send orders and read stock data from their own systems. Access is granted per client after a short onboarding.
Contact us and send the public IP addresses your system will call from. We add them to the allowlist and issue your X-Client-Code and X-Api-Key. The key is shown only once, so store it securely — if it is lost, we issue a new one.
Order lines can carry decoration data for embroidery, screen print, digital print, transfer and sewing, together with placement, size in centimetres, number of colours or stitches, Pantone references and links to artwork files. Order lines can be Standard, print-on-demand (POD) or stock.
Submitting an order returns a correlationId. Use it to check the order status: ACCEPTED means it reached production, SHIPPED means it is on its way with a tracking number, and REJECTED lists the fields to correct. There are no callbacks yet — polling once every 15 minutes per order is recommended.
Availability is refreshed every 3 hours and shows quantities in the Lynka warehouse and at the vendor for the SKUs in your catalogue. One full download every few hours, or an incremental call for changed records, keeps your shop up to date.
Yes. Every integration starts on the test environment with test credentials. The production URL is provided before go-live.
Request access and we will send you the full LynkaHub API documentation (v1.07), test credentials and onboarding details.