Public APIs for partner integration
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"38276441","collectionId":"633de793-24c8-4c67-a435-c0ea19683358","publishedId":"2sBXVbHtQp","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-12-30T07:25:44.000Z"},"item":[{"name":"APIs","item":[{"name":"Order By Number","id":"33c63593-5f28-4ef2-bbe3-eae76d55de0c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Accept","value":"text/plain"},{"key":"X-API-KEY","value":"1ad64d17-01d9-475c-bb71-40e5b97a5552","type":"text"}],"url":"//api/v1/store/order/details?orderNo=767757502277","description":"Retrieve detailed information for a single order using its unique order number.
\nMethod: GET
URL: //api/v1/store/order/details
Full example URL:
\n GET //api/v1/store/order/details?orderNo=961541674132\n\nThis endpoint expects the order number as a query parameter and returns the corresponding order details when found.
\norderNo must correspond to an existing order in the store.\n\nNote: Use your own valid API key in
\nX-API-KEYwhen calling this endpoint in non-demo environments.
This endpoint uses an API key passed via the X-API-KEY header.
Requests without a valid API key, or with an expired/invalid key, will fail with a 4xx client error (for example, 401 Unauthorized or 403 Forbidden).
Status: 200 OK
Description: Returns the full details for the order that matches the supplied orderNo.
Body: JSON or text representation of the order details (exact structure depends on the backend implementation).
\nA representative success response is documented in the existing OK example associated with this request. Refer to that example for the concrete response shape.
Common error scenarios include invalid input, missing authentication, or server-side failures.
\n","urlObject":{"path":["api","v1","store","order","details"],"host":["/"],"query":[{"key":"orderNo","value":"767757502277"}],"variable":[]}},"response":[{"id":"af39a419-27a8-4788-bc22-66808f2c3176","name":"OK","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"text/plain"},{"description":"Added as a part of security scheme: apikey","key":"X-API-KEY","value":"Create a new order in the LPrint Cloud Store.
\nThis endpoint accepts full order details, including billing and shipping addresses, line items with print media details, and optional package insert information. It returns a plain text response indicating the result of the operation.
\nMethod: POST
URL: //api/v1/store/order
/ is a variable that should point to the base URL of the LPrint Cloud Store API .
Authentication:
\nTypically uses an API key or token configured at the collection/environment level.
\nThis request references the variable apiKey (and global AccessToken is available in the workspace). Ensure your auth is configured appropriately in the Authorization tab or via headers.
Required headers:
\nContent-Type: application/json
Accept: text/plain
The request body is a JSON object with the following structure:
\n{\n \"orderNumber\": \"ORD-2025-000456\",\n \"shipMethodName\": \"standard\",\n \"billAddress\": {\n \"firstName\": \"Amit\",\n \"lastName\": \"Verma\",\n \"address1\": \"45 Park Street\",\n \"address2\": \"Near City Mall\",\n \"email\": \"amit.verma@example.com\",\n \"phone1\": \"+919845672310\",\n \"phone2\": \"+919812309876\",\n \"postalCode\": \"110001\",\n \"city\": \"New Delhi\",\n \"province\": \"Delhi\",\n \"provinceCode\": \"DL\",\n \"countryCode\": \"IN\"\n },\n \"shipAddress\": {\n \"firstName\": \"Amit\",\n \"lastName\": \"Verma\",\n \"address1\": \"45 Park Street\",\n \"address2\": \"Near City Mall\",\n \"email\": \"amit.verma@example.com\",\n \"phone1\": \"+919845672310\",\n \"phone2\": \"+919812309876\",\n \"postalCode\": \"110001\",\n \"city\": \"New Delhi\",\n \"province\": \"Delhi\",\n \"provinceCode\": \"DL\",\n \"countryCode\": \"IN\"\n },\n \"comments\": \"Please pack securely and avoid folding the printed area.\",\n \"orderItems\": [\n {\n \"sku\": \"TSHIRT-WHT-M\",\n \"quantity\": 2,\n \"printType\": \"dtg\",\n \"printMedia\": [\n {\n \"printPosition\": \"front\",\n \"printImageUrl\": \"https://cdn.example.com/prints/front-design.png\",\n \"previewImageUrl\": \"https://cdn.example.com/previews/front-preview.png\",\n \"imageHeight\": 2400,\n \"imageWidth\": 1800\n }\n ]\n }\n ],\n \"packageInsert1\": \"Thank you for your order!\",\n \"packageInsert2\": \"Visit us again at www.example.com\"\n}\n\n shipMethodName:\n type: string\n description: Shipping method code or name that determines how the order will be shipped.\n example: standard\n billAddress:\n $ref: '#/components/schemas/Address'\n shipAddress:\n $ref: '#/components/schemas/Address'\n comments:\n type: string\n description: Free-form text notes or special instructions for this order.\n example: Please pack securely.\n orderItems:\n type: array\n description: List of line items included in the order.\n items:\n $ref: '#/components/schemas/OrderItem'\n packageInsert1:\n type: string\n description: Optional package insert message.\n example: Thank you for your order!\n packageInsert2:\n type: string\n description: Optional secondary package insert message.\n example: Follow us on Instagram.\nAddress:\n type: object\n required:\n - firstName\n - lastName\n - address1\n - email\n - phone1\n - postalCode\n - city\n - province\n - provinceCode\n - countryCode\n properties:\n firstName:\n type: string\n description: Customer first name.\n example: Amit\n lastName:\n type: string\n description: Customer last name.\n example: Verma\n address1:\n type: string\n description: Primary street address.\n example: 45 Park Street\n address2:\n type: string\n description: Secondary address line.\n example: Near City Mall\n email:\n type: string\n format: email\n description: Customer email address.\n example: amit.verma@example.com\n phone1:\n type: string\n description: Primary contact phone number.\n example: +919845672310\n phone2:\n type: string\n description: Secondary contact phone number.\n example: +919812309876\n postalCode:\n type: string\n description: Postal or ZIP code.\n example: 110001\n city:\n type: string\n description: City name.\n example: New Delhi\n province:\n type: string\n description: State or province name.\n example: Delhi\n provinceCode:\n type: string\n description: State or province code.\n example: DL\n countryCode:\n type: string\n description: ISO country code.\n example: IN\nOrderItem:\n type: object\n required:\n - sku\n - quantity\n - printType\n - printMedia\n properties:\n sku:\n type: string\n description: Unique product SKU.\n example: TSHIRT-WHT-M\n quantity:\n type: integer\n minimum: 1\n description: Quantity of the item ordered.\n example: 2\n printType:\n type: string\n description: Printing method used for the item.\n enum:\n - dtg\n - dtf\n example: dtg\n printMedia:\n type: array\n description: List of print media configurations for the item.\n items:\n $ref: '#/components/schemas/PrintMedia'\nPrintMedia:\n type: object\n required:\n - printPosition\n - printImageUrl\n properties:\n printPosition:\n type: string\n description: Position of the print on the product.\n enum:\n - front\n - back\n - pocket\n - sleeve\n example: front\n printImageUrl:\n type: string\n format: uri\n description: URL of the print-ready image.\n example: https://cdn.example.com/prints/front-design.png\n previewImageUrl:\n type: string\n format: uri\n description: URL of the preview image.\n example: https://cdn.example.com/previews/front-preview.png\n imageHeight:\n type: integer\n minimum: 1\n maximum: 5000\n description: Height of the print image in pixels.\n example: 2400\n imageWidth:\n type: integer\n minimum: 1\n maximum: 5000\n description: Width of the print image in pixels.\n example: 1800\n\nPrint Position -
\nType: Enum
Required: Yes
Must be a valid value from the PrintPosition enum.
Invalid enum values will be rejected.
\nInvalid print position.\n\nDefines where the print will appear on the product (e.g., Front, Back, Pocket).
\nType: String
Required: Yes
Cannot be empty or null.
\nMust be a valid URL format.
\nPrintImageUrl is required.\nPrintImageUrl must be a valid URL.\n\nType: String
Required: No
Optional field.
\nIf provided, it must be a valid URL format.
\nPreviewImageUrl must be a valid URL.\n\nProvides an optional preview image URL for UI display or customer preview purposes.
\nType: Integer
Required: No
Must be greater than 0.
Validation is applied only when a value is provided.
\n{\n \"field\": \"Sku\",\n \"message\": \"SKU 'TSHIRT-WHT-M' not mapped with your store\"\n }\n]\n\nRepresents the height of the print image in pixels.
\nType: Integer
Required: No
Must be greater than 0.
Validation is applied only when aach invalid field.
\nMultiple validation errors may be returned in a single response.
\nCancels an existing store order by its order number.
\nUse this endpoint to cancel an order that is currently in a cancellable state. The order is identified by the orderNo path variable, and a cancellation reason must be supplied via the reason query parameter.
Method: PUT
URL: //api/v1/store/order/cancel/:orderNo?reason=string
orderNo (string, required)
The unique order number of the store order to cancel.
\nExample: ORD-123456
reason (string, required)
Human-readable explanation for why the order is being cancelled.
\nExample: Customer requested cancellation.
X-API-KEY (string, required)
API key used to authenticate the request.
\nExample: 65a61b57-1695-4f9a-a9f8-5587bea98330 (sample value).
Accept (string, optional/required as per API policy)
Indicates the expected response media type.
\nFor this endpoint, typically set to:
\nJsonSuccess (e.g., 200 OK)
\nThe specified order is successfully cancelled.
\nThe response body may contain a confirmation message or status indicating that the order is now cancelled.
\nTypical Error Cases
\n400 Bad Request – Missing or invalid orderNo or reason parameter.
401 Unauthorized / 403 Forbidden – Invalid or missing X-API-KEY.
404 Not Found – No order found for the provided orderNo.
409 Conflict – Order cannot be cancelled (e.g., already shipped or in a non-cancellable state).
PUT https://www.lprintcloud.com/storeapis/api/v1/store/order/cancel/ORD-123456?reason=Customer requested cancellation\nX-API-KEY: 65a61b57-1695-4f9a-a9f8-5587bea98330\nAccept: text/plain\n\nThe API validates the orderNo, checks that the order is in a cancellable state, records the reason, and marks the order as cancelled.
A success message or representation of the cancelled order is returned, depending on server implementation.
\nRetrieves a paginated list of store orders that match the provided filters.
\nHTTP: GET //api/v1/store/order
Uses an API key passed in the X-API-KEY header.
The client must include a valid key for the request to be authorized.
\nRequired header example:
\nX-API-KEY: {Your API Key)\nAccept: Json\n\nAll parameters are optional filters unless otherwise noted.
\norderStatus ([1,2,3])
Filters orders by status code.
\nExample:
\norderNo (string)
Filters by a specific order number.
\nExample: string
startDate (string)
Inclusive start of the order creation date range.
\nFormat: YYYY-MM-DDTHH:mm:ss.SSSZ
Examples:
\n2025-09-23T18:14:38.937Z
2026-09-23T18:14:38.937Z
1978-09-23T18:14:38.937Z
endDate (string)
Inclusive end of the order creation date range.
\nFormat: YYYY-MM-DDTHH:mm:ss.SSSZ
Examples:
\n2026-09-23T18:14:38.937Z
2025-09-23T18:14:38.937Z
1978-09-23T18:14:38.937Z
pageIndex (integer)
Zero‑ or one‑based index of the page to retrieve (depending on API implementation).
\nExamples: 1
pageSize (integer)
Number of orders returned per page.
\nExamples: 10
200 OK
\nOther status codes may be returned for authentication or validation errors (e.g., 400/403 for invalid or missing X-API-KEY).
Inclusive start of order creation date range (ISO 8601).
\n","type":"text/plain"},"key":"startDate","value":"2025-09-23T18:14:38.937Z"},{"description":{"content":"Inclusive end of order creation date range (ISO 8601).
\n","type":"text/plain"},"key":"endDate","value":"2026-09-23T18:14:38.937Z"},{"description":{"content":"1-based index of the results page to return.
\n","type":"text/plain"},"key":"pageIndex","value":"1"},{"description":{"content":"Number of records per page.
\n","type":"text/plain"},"key":"pageSize","value":"10"}],"variable":[]}},"response":[{"id":"5d2771c2-9cbc-4419-b931-760813ffa6e0","name":"OK","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"text/plain"},{"description":"Added as a part of security scheme: apikey","key":"X-API-KEY","value":"Retrieves the latest status and event history for a specific store order, identified by its order number.
\nUse this endpoint to track the lifecycle of an order (for example: created, in production, shipped, delivered) and to display order status updates in your application.
\nMethod: GET
URL: //api/v1/store/order/events/:orderNo
Using the current path variable value:
\n//api/v1/store/order/events/961541674132\n\n\n\nNote: In real environments, use a secure variable (for example,
\n{{apiKey}}) instead of a hard-coded API key value.
GET method.Based on the existing saved example:
\nStatus: 200 OK
Description: The order was found and its events were returned successfully.
\nBody: Text or structured content describing the order status/events (see the saved example attached to this request for the exact format).
\nX-API-KEY or an order number that does not exist).Unique order number for which to fetch status and event history.
\n","type":"text/plain"},"type":"any","value":"767757502277","key":"orderNo"}]}},"response":[{"id":"114aa549-17c3-4af4-90bc-7fa653527219","name":"OK","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"text/plain"},{"description":"Added as a part of security scheme: apikey","key":"X-API-KEY","value":"Update customer shipping information
\nCorrect address or contact details
\nEnsure accurate delivery and shipping label generation
\n{\n \"orderNo\": \"572877594270\",\n \"shipFirstName\": \"Rohit\",\n \"shipLastName\": \"Kumar\",\n \"shipAddress1\": \"221B Residency Road\",\n \"shipAddress2\": \"Near Central Park\",\n \"shipEmail\": \"rohit.kumar@example.com\",\n \"shipPhone1\": \"+919876543210\",\n \"shipPhone2\": \"+919812345678\",\n \"shipPostalCode\": \"400001\",\n \"shipCity\": \"Mumbai\",\n \"shipProvince\": \"Maharashtra\",\n \"shipProvinceCode\": \"MH\"\n}\n\nThis API allows clients to upload multiple orders in a single request.
\nEach order can include billing details, shipping details, order items, print configurationsEndFragment
\nhttps://lprintcloud.com/storeapis/api/v1/store/order/bulk\n\nCreate multiple orders in one API call
\nReduce API overhead for bulk uploads
\nEnsure consistent order, print, and shipping data
\nSupport automated print-on-demand workflows
\nEach object inside orders represents one complete order.
Each item represents a printable product.
\nDefines how and where the artwork will be printed.
\n{\n \"orders\": [\n {\n \"orderNumber\": \"ORD-100245\",\n \"shipMethodName\": \"standard\",\n \"billAddress\": {\n \"firstName\": \"Rohit\",\n \"lastName\": \"Kumar\",\n \"address1\": \"221B Residency Road\",\n \"address2\": \"Near Central Park\",\n \"email\": \"rohit.kumar@example.com\",\n \"phone1\": \"+919876543210\",\n \"phone2\": \"+919812345678\",\n \"postalCode\": \"400001\",\n \"city\": \"Mumbai\",\n \"province\": \"Maharashtra\",\n \"provinceCode\": \"MH\",\n \"countryCode\": \"IN\"\n },\n \"shipAddress\": {\n \"firstName\": \"Rohit\",\n \"lastName\": \"Kumar\",\n \"address1\": \"221B Residency Road\",\n \"address2\": \"Near Central Park\",\n \"email\": \"rohit.kumar@example.com\",\n \"phone1\": \"+919876543210\",\n \"phone2\": \"+919812345678\",\n \"postalCode\": \"400001\",\n \"city\": \"Mumbai\",\n \"province\": \"Maharashtra\",\n \"provinceCode\": \"MH\",\n \"countryCode\": \"IN\"\n },\n \"comments\": \"Please handle the package carefully.\",\n \"orderItems\": [\n {\n \"sku\": \"TSHIRT-BLK-M\",\n \"quantity\": 2,\n \"printType\": \"dtg\",\n \"printMedia\": [\n {\n \"printPosition\": \"front\",\n \"printImageUrl\": \"https://example.com/images/print/front-design.png\",\n \"previewImageUrl\": \"https://example.com/images/preview/front-preview.png\",\n \"imageHeight\": 2400,\n \"imageWidth\": 1800\n }\n ]\n }\n ],\n \"packageInsert1\": \"Valid URL\",\n \"packageInsert2\": \"Valid URL\"\n }\n ]\n}\n\n{\n \"status\": \"SUCCESS\",\n \"message\": \"Orders created successfully\",\n \"totalOrders\": 10,\n \"acceptedOrders\": 10,\n \"failedOrders\": 0\n}\n\nInvalid SKU
\nUnsupported printType
\nMissing required fields
\nInvalid image URLs
\nAddress validation failure
\nThis collection contains HTTPs endpoints for interacting with the LPrint Cloud Store services. The requests are organized under the APIs folder and are intended to be used from trusted backend environments or authorized clients.
\n","_postman_id":"fdbc78cd-0dbb-41a9-861d-a6d61c462608","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-KEY"},{"key":"value","value":"{{apiKey}}"}]},"isInherited":true,"source":{"_postman_id":"633de793-24c8-4c67-a435-c0ea19683358","id":"633de793-24c8-4c67-a435-c0ea19683358","name":"LPrint Cloud Store Open Api","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-KEY"},{"key":"value","value":"{{apiKey}}"}]}},"variable":[{"key":"baseUrl","value":"/"}]}