# Cancel order Source: https://nocnoc.mintlify.app/api/api-reference/orders/cancel-order POST https://live.nocnocstore.com/api/v2/orders/{order_id}/cancellation Submits a cancellation request for a specific order. ## Path parameters The ID of the order to cancel. ## Returns A confirmation that the cancellation request was submitted. ## Example request ```bash theme={null} curl -X POST https://live.nocnocstore.com/api/v2/orders/ORD-123456/cancellation \ -H "X-Api-Key: YOUR_SELLER_KEY" ``` ```json 201 theme={null} {} ``` ```json 400 theme={null} { "code": 400, "message": "An order issue already exists for order: order_id and type: cancellation_request and status: open" } ``` ```json 401 theme={null} { "code": 401, "message": "Unauthorized" } ``` ```json 404 theme={null} { "code": 404, "message": "Order not found" } ``` ```json 409 theme={null} { "message": "Invalid Request" } ``` # List orders Source: https://nocnoc.mintlify.app/api/api-reference/orders/list-orders GET https://live.nocnocstore.com/api/v2/orders Returns all orders associated with your account. Supports filtering by status, date range, and order ID. ## Query parameters Page number. Pagination starts at index zero. Number of results per page. Filter by order status. Possible values: `in_process`, `cancelled`. Filter orders created from this date. Filter orders created up to this date. Filter to retrieve a specific order by ID. ## Returns A paginated list of orders associated with your account, including order ID, status, items, and shipping details. ## Example request ```bash theme={null} curl "https://live.nocnocstore.com/api/v2/orders?page=0&size=10&statuses=in_process" \ -H "X-Api-Key: YOUR_SELLER_KEY" ``` ```json 200 theme={null} { "orders": [ { "tracking_id": "NC2202936", "label_url": "https://www.live.nocnocstore.com/token/OL2342342.234234", "created_at": "2025-05-16 08:39:29", "status": "in_process", "status_date": "2025-05-16 08:45:39", "status_description": null, "customer": { "full_name": "Joe Doe", "tax_id": "01564525295" }, "products": [ { "sku": "6291107456058", "quantity": 1, "fob_price": "20.00" } ], "delivery_address": { "contact_name": "Nocnoc", "belongs_to": "NOCNOC", "contact_phone": "3055134548 Ext 70129", "street": "13150 NW 25TH ST", "street_2": "", "zipcode": "33182-1532", "region": "Florida", "city": "Miami", "country": "US", "deadline": "2025-05-18" } } ] } ``` ```json 401 theme={null} { "code": 401, "message": "Unauthorized" } ``` # Overview Source: https://nocnoc.mintlify.app/api/api-reference/overview The nocnoc API v2 — base URL, versioning, request format, and authentication. The nocnoc API gives sellers programmatic access to products, orders, and packages. ## Base URL All requests go to the live environment: ``` https://live.nocnocstore.com/api/v2 ``` ## Versioning The current version is **v2**. The version is included in the base URL. ## Request format * All request bodies must be sent as JSON with the `Content-Type: application/json` header. Requests without it will return a `415 Unsupported Media Type` error. * All responses are returned as JSON. ## Authentication Every request requires two headers: | Header | Value | | -------------- | ------------------- | | `X-Api-Key` | Your seller API key | | `Content-Type` | `application/json` | ```bash theme={null} curl https://live.nocnocstore.com/api/v2/products \ -H "X-Api-Key: YOUR_SELLER_KEY" \ -H "Content-Type: application/json" ``` A missing or invalid key returns a `401 Unauthorized` response. See [Response codes](/api/api-reference/responses) for the full list of error codes. No IP allowlist is required. The API accepts requests from any origin IP address. # Create Father package Source: https://nocnoc.mintlify.app/api/api-reference/packages/create-father-package POST https://live.nocnocstore.com/api/v2/packages Creates a Father package by consolidating multiple Son packages for bulk first-mile shipping. nocnoc manages two types of packages: **Son** and **Father**. You must first create individual [Son packages](/api/api-reference/packages/create-son-package) before grouping them into a Father package. ## Body parameters Array of Son package IDs to include in this Father package. Array of label objects for the consolidated shipment. Minimum 1, maximum 10. Each object contains: * `tracking_code` (string, required) — tracking code of the consolidated package * `carrier` (string, required) — first-mile carrier (e.g. `"FedEx"`, `"UPS"`) * `url` (string, required) — URL to track the shipment ## Returns The created Father package object confirming the consolidated shipment. ## Example request ```bash theme={null} curl -X POST https://live.nocnocstore.com/api/v2/packages \ -H "X-Api-Key: YOUR_SELLER_KEY" \ -H "Content-Type: application/json" \ -d '{ "labels": [ { "tracking_code": "FX2021", "carrier": "FedEx", "url": "https://www.fedex.com/tracking/FX2021" } ], "subpackages": ["PK1", "PK2", "PK3"] }' ``` ```json 201 theme={null} { "package_id": "PK111" } ``` # Create Son package Source: https://nocnoc.mintlify.app/api/api-reference/packages/create-son-package POST https://live.nocnocstore.com/api/v2/packages Creates a Son package for a single order. Each order requires its own Son package. nocnoc manages two types of packages: **Son** and **Father**. Create a Son package per order, then group multiple Son packages into a [Father package](/api/api-reference/packages/create-father-package) for consolidated first-mile shipping. ## Body parameters The reference ID of the order included in this package. Array of label objects. Minimum 1, maximum 10. Each object contains: * `tracking_code` (string) — tracking code of the package * `carrier` (string) — first-mile carrier (e.g. `"FedEx"`, `"UPS"`). Use `"nocnoc"` for a nocnoc label * `url` (string) — URL to track the order Array of item objects inside the package. Minimum 1, maximum 10. Each object contains: * `sku` (string) — item SKU, between 1 and 45 characters * `quantity` (integer) — quantity of the item, between 0 and 9999 ## Returns The created Son package object with its package ID, which you'll need to create a Father package. ## Example request ```bash theme={null} curl -X POST https://live.nocnocstore.com/api/v2/packages \ -H "X-Api-Key: YOUR_SELLER_KEY" \ -H "Content-Type: application/json" \ -d '{ "order_reference_id": "NC0000", "labels": [ { "tracking_code": "1234", "carrier": "nocnoc", "url": "https://tracking.example.com/1234" } ], "items": [ { "sku": "SKU00000000", "quantity": 1 } ] }' ``` ```json 201 theme={null} { "package_id": "PK111" } ``` # Create product Source: https://nocnoc.mintlify.app/api/api-reference/products/create-product POST https://live.nocnocstore.com/api/v2/products Creates a new product and adds it to your catalog. Requires full product data. If you have an Amazon ASIN, use [Create product by ASIN](/api/api-reference/products/create-product-asin) instead — it auto-populates product data automatically. ## Body parameters Alphanumeric unique code for the product. Between 1 and 45 characters. Brand of the product. Between 1 and 45 characters. Stock quantity. Between 0 and 9999. Price of the product. Up to 10 integer digits and 2 decimal places. Currency code (ISO). Currently only `USD` is supported. Product title to be published. Product description to be published. Language of the description. Currently only `en` is supported. Product condition. One of: `NEW`, `USED`, `OPEN_BOX`, `REFURBISHED_A`, `REFURBISHED_B`, `REFURBISHED_C`, `REFURBISHED_D`. Defaults to `NEW`. Dimensions of the package. Contains `size` (object with `unit`, `length`, `width`, `height`) and `weight` (object with `unit`, `value`). Size units: `cm`, `inch`, `inches`, `mm`. Weight units: `kg`, `lb`, `gram`, `kilogram`, `pound`. Dimensions of the product itself. Same structure as `package_dimensions`. Array of image objects, each with a `source_url` field. Minimum 1, maximum 10. International identifiers. Contains `gtin` (array of strings — Global Trade Item Number, e.g. EAN, UPC). Additional product attributes. Each object has `type` (one of: `COLOR`, `SIZE`) and `value` (string). ## Returns The created product object with all submitted fields confirmed. ## Example request ```bash theme={null} curl -X POST https://live.nocnocstore.com/api/v2/products \ -H "X-Api-Key: YOUR_SELLER_KEY" \ -H "Content-Type: application/json" \ -d '{ "sku": "SKU-001", "international_ids": { "gtin": ["4901234567890"] }, "brand": "BRAND", "available_quantity": 20, "price": 23, "currency_code": "USD", "package_dimensions": { "size": { "unit": "cm", "length": 46, "width": 28, "height": 15 }, "weight": { "unit": "kg", "value": 3 } }, "product_dimensions": { "size": { "unit": "cm", "length": 42, "width": 26, "height": 13 }, "weight": { "unit": "kg", "value": 2 } }, "images": [{ "source_url": "https://example.com/image.jpg" }], "condition": "NEW", "title": "Product Title", "description_language": "en", "description": "Product description", "attributes": [ { "type": "COLOR", "value": "Red" }, { "type": "SIZE", "value": "Large" } ] }' ``` ```json 201 theme={null} { "sku": "SKU-001", "brand": "BRAND", "available_quantity": 20, "price": 23, "currency_code": "USD", "package_dimensions": { "size": { "unit": "cm", "width": 28, "height": 15, "length": 46 }, "weight": { "value": 3, "unit": "kg" } }, "product_dimensions": { "size": { "unit": "cm", "width": 26, "height": 13, "length": 42 }, "weight": { "value": 2, "unit": "kg" } }, "images": [{ "source_url": "https://example.com/image.jpg" }], "condition": "NEW", "title": "Product Title", "description_language": "en", "description": "Product description", "attributes": [ { "type": "COLOR", "value": "Red" }, { "type": "SIZE", "value": "Large" } ] } ``` ```json 400 theme={null} { "code": 400, "message": "Invalid Request Payload.", "errors": [ "Sku should be between 1 character minimum and 45 characters maximum.", "Brand should be between 1 character minimum and 45 characters maximum." ] } ``` ```json 400 theme={null} { "code": 400, "message": "Sku already exists." } ``` ```json 401 theme={null} { "code": 401, "message": "Unauthorized" } ``` # Create product by ASIN Source: https://nocnoc.mintlify.app/api/api-reference/products/create-product-asin POST https://live.nocnocstore.com/api/v2/products/ Creates a new product using an Amazon ASIN to auto-populate product data. ## Body parameters Alphanumeric unique code for the product. Between 1 and 45 characters. Must include `asin` as an array of strings. Example: `{"asin": ["B00QAIV7V2"]}`. Stock quantity. Between 0 and 9999. Price of the product. Up to 10 integer digits and 2 decimal places. Currency code (ISO). Required if `price` is provided. Currently only `USD` is supported. ## Returns The created product object with data populated from the Amazon ASIN. ## Example request ```bash theme={null} curl -X POST https://live.nocnocstore.com/api/v2/products/ \ -H "X-Api-Key: YOUR_SELLER_KEY" \ -H "Content-Type: application/json" \ -d '{ "sku": "SKU123", "international_ids": { "asin": ["B00QAIV7V2"] }, "available_quantity": 10, "price": 100, "currency_code": "USD" }' ``` ```json 200 theme={null} { "sku": "MY-SKU-002", "title": "Product title from Amazon", "brand": "Brand from Amazon", "price": 49.99, "currency_code": "USD", "available_quantity": 50, "status": "active" } ``` ```json 400 theme={null} { "code": 400, "message": "Sku already exists." } ``` ```json 401 theme={null} { "code": 401, "message": "Unauthorized" } ``` # Get product by SKU Source: https://nocnoc.mintlify.app/api/api-reference/products/get-product GET https://live.nocnocstore.com/api/v2/products/sku/{sku} Returns the complete information for a single product identified by its SKU. ## Path parameters The unique SKU of the product. ## Returns The complete product data for the given SKU, including price, stock, dimensions, images, and attributes. ## Example request ```bash theme={null} curl https://live.nocnocstore.com/api/v2/products/sku/MY-SKU-001 \ -H "X-Api-Key: YOUR_SELLER_KEY" ``` ```json 200 theme={null} { "sku": "TEST1", "created_at": "2023-06-21 18:35:14", "updated_at": "2023-06-23 18:35:14", "international_ids": { "asin": "BTEST1", "gtin": ["123123TEST1"] }, "brand": "MyBrand", "available_quantity": 100, "price": 19.99, "currency_code": "USD", "status": "SUCCESS", "package_dimensions": { "size": { "unit": "inches", "width": 5.0, "height": 5.0, "length": 3.0 }, "weight": { "value": 1.5, "unit": "kg" } }, "product_dimensions": { "size": { "unit": "inches", "width": 20.0, "height": 10.0, "length": 5.0 }, "weight": { "value": 2.0, "unit": "kg" } }, "images": [ { "source_url": "https://example.com/image.jpg" } ], "title": "Product Title", "description_language": "en", "description": "Product description", "description_html": "

Product description in HTML

", "attributes": [ { "type": "COLOR", "value": "Red" }, { "type": "SIZE", "value": "Large" } ] } ``` ```json 401 theme={null} { "code": 401, "message": "Unauthorized" } ``` ```json 404 theme={null} { "code": 404, "message": "Sku not found" } ``` # Get products Source: https://nocnoc.mintlify.app/api/api-reference/products/list-products GET https://live.nocnocstore.com/api/v2/products Returns all your published products. Supports filtering by date and pagination. ## Query parameters Filter products updated from this date. Format: `yyyy-MM-dd'T'HH:mm:ss.SS'Z'` Filter products updated up to this date. Format: `yyyy-MM-dd'T'HH:mm:ss.SS'Z'` Page number for pagination. Number of results per page. ## Returns A paginated list of your published products, including SKU, title, price, stock, dimensions, images, and attributes. ## Example request ```bash theme={null} curl https://live.nocnocstore.com/api/v2/products?page=1&size=10 \ -H "X-Api-Key: YOUR_SELLER_KEY" ``` ```json 200 theme={null} { "products": [ { "sku": "TEST1", "created_at": "2023-06-21 18:35:14", "updated_at": "2023-06-23 18:35:14", "international_ids": { "asin": "BTEST1", "gtin": ["123123TEST1"] }, "brand": "MyBrand", "available_quantity": 100, "price": 19.99, "currency_code": "USD", "status": "SUCCESS", "package_dimensions": { "size": { "unit": "inches", "width": 5.0, "height": 5.0, "length": 3.0 }, "weight": { "value": 1.5, "unit": "kg" } }, "product_dimensions": { "size": { "unit": "inches", "width": 20.0, "height": 10.0, "length": 5.0 }, "weight": { "value": 2.0, "unit": "kg" } }, "images": [ { "source_url": "https://example.com/image.jpg" } ], "title": "Product Title", "description_language": "en", "description": "Product description", "description_html": "

Product description in HTML

", "attributes": [ { "type": "COLOR", "value": "Red" }, { "type": "SIZE", "value": "Large" } ] } ] } ``` ```json 400 theme={null} { "code": 400, "message": "Invalid query parameter format." } ``` ```json 401 theme={null} { "code": 401, "message": "Unauthorized" } ``` # Update stock and price Source: https://nocnoc.mintlify.app/api/api-reference/products/update-stock-price PATCH https://live.nocnocstore.com/api/v2/products/sku/{sku} Updates the stock quantity and/or price of an existing product. At least one of `available_quantity` or `price` must be provided. If `price` is provided, `currency_code` is required. ## Path parameters The SKU of the product to update. ## Body parameters New stock quantity. Between 0 and 9999. Required if `price` is not provided. New price. Required if `available_quantity` is not provided. Currency code (ISO). Required if `price` is provided. Currently only `USD` is supported. ## Returns The updated product object reflecting the new stock and/or price. ```json 200 theme={null} { "sku": "MY-SKU-001", "available_quantity": 75, "price": 24.99, "currency_code": "USD" } ``` ```json 400 theme={null} { "code": 400, "message": "Invalid Request Payload.", "errors": [ "available_quantity or price is required." ] } ``` ```json 401 theme={null} { "code": 401, "message": "Unauthorized" } ``` ```json 404 theme={null} { "code": 404, "message": "Sku not found" } ``` # Response codes Source: https://nocnoc.mintlify.app/api/api-reference/responses HTTP status codes and error structures returned by the nocnoc API. The nocnoc API uses standard HTTP status codes to indicate the result of every request. ## Status codes | Code | Meaning | When it happens | | ----- | ---------------------- | ------------------------------------------------------------- | | `200` | OK | Request succeeded. | | `201` | Created | Resource created successfully. | | `400` | Bad Request | Invalid payload, missing required fields, or duplicate SKU. | | `401` | Unauthorized | Missing or invalid API key. | | `404` | Not Found | The requested resource does not exist. | | `409` | Conflict | The request conflicts with the current state of the resource. | | `415` | Unsupported Media Type | Missing `Content-Type: application/json` header. | | `500` | Internal Server Error | An unexpected error occurred on nocnoc's side. | ## Error response structure All errors return a consistent JSON structure: ```json theme={null} { "code": 401, "message": "Unauthorized" } ``` Validation errors (400) may include an additional `errors` array with field-level details: ```json theme={null} { "code": 400, "message": "Invalid Request Payload.", "errors": [ "Sku should be between 1 character minimum and 45 characters maximum.", "Brand should be between 1 character minimum and 45 characters maximum." ] } ``` # Sending packages Source: https://nocnoc.mintlify.app/api/guides/sending-packages Learn how nocnoc's two-tier package model works and how to register shipments. nocnoc manages shipments using two types of packages: **Son** and **Father**. * A **Son package** represents a single order ready to ship. * A **Father package** consolidates multiple Son packages into one bulk first-mile shipment. ## Individual shipment When you have a single order to ship, create one Son package for it. Individual shipment ## Consolidated shipment When you have multiple orders ready to ship together, create a Son package per order and then group them into a single Father package. Consolidated shipment ## How it works For each order you're ready to ship, call [Create Son package](/api/api-reference/packages/create-son-package) with the order reference ID, labels, and items. If you're shipping multiple orders together, call [Create Father package](/api/api-reference/packages/create-father-package) with the Son package IDs. Skip this step for individual shipments. # Introduction Source: https://nocnoc.mintlify.app/api/introduction nocnoc gives marketplace sellers a single API to publish products, handle orders, and manage shipments — all from `live.nocnocstore.com`. ## What you can do Create listings manually or from an Amazon ASIN. Update your products' stock and pricing in real time across all your channels. Fetch incoming orders with filters for status and date range. Cancel orders when needed. Send individual or consolidated packages and handle first-mile shipping. ## Base URL All requests go to the live environment: ``` https://live.nocnocstore.com/api/v2 ``` nocnoc currently operates a single live environment. A sandbox is under development — contact your Account Manager to arrange testing with fake orders and products in the meantime. # Quick Start Source: https://nocnoc.mintlify.app/api/quickstart Get authenticated and make your first API call. This guide gets you set up with the nocnoc API — from understanding the environment to making your first authenticated request. ## Environment nocnoc runs a single live environment. Every request you make is processed as a real transaction against real data. | Property | Value | | -------- | ------------------------------------- | | Base URL | `https://live.nocnocstore.com/api/v2` | | Status | Active | All requests are live. Any products you create or orders you place affect real customers. Coordinate with your Account Manager before running volume tests. ## Authentication nocnoc uses API keys. Include your `SELLER_KEY` in the `X-Api-Key` header on every request. Your key is provided by the nocnoc team — contact your Account Manager if you don't have one yet. Every request must also include the `Content-Type: application/json` header. Requests without it will return a `415 Unsupported Media Type` error. | Header | Value | | -------------- | ------------------- | | `X-Api-Key` | Your seller API key | | `Content-Type` | `application/json` | No IP allowlist configuration is required. The API accepts requests from any origin IP address. ## Your first request ```bash theme={null} curl https://live.nocnocstore.com/api/v2/products \ -H "X-Api-Key: YOUR_SELLER_KEY" \ -H "Content-Type: application/json" ``` A `200` response confirms your key is valid. A `401` indicates the key is missing or incorrect. # Create new products in nocnoc from GoFlow Source: https://nocnoc.mintlify.app/goflow/create-listings How to create new nocnoc products directly from GoFlow using Amazon ASINs. If you have products that don't exist yet in nocnoc, you can create them directly from GoFlow using Amazon ASINs. GoFlow looks up the listing details on Amazon and uses them to build your nocnoc catalog automatically — you only need to provide minimal data. ## Creating listings in bulk From the sidebar, go to **Directory → Stores** and open your nocnoc store. In the upper-right corner, click the **Upload** icon and select **Create Listings**. Upload your file — the only required column is **Item Number**. GoFlow will automatically fill in any missing fields (ASIN, price, SKU, unit of measure) by looking them up from your mapped Amazon listings. ### Example file | Item Number | ASIN | Price | SKU | Unit of Measure | | ----------- | ---------- | ----- | ------- | --------------- | | ITEM-001 | B08N5WRWNW | 29.99 | SKU-001 | CS | | ITEM-002 | | | | | In the example above, **ITEM-002** only requires the Item Number — GoFlow handles the rest by pulling the data from your mapped Amazon listings. # Link existing nocnoc products to GoFlow Source: https://nocnoc.mintlify.app/goflow/enable-listings-import How to import your existing nocnoc products into GoFlow automatically. If you already have products created in nocnoc — whether through your account manager or directly in Seller Center — you can have GoFlow automatically import them. When listings import is enabled, GoFlow periodically checks nocnoc for new products and pulls them into your GoFlow nocnoc store. This is a one-way sync: GoFlow looks for products that exist in nocnoc but aren't yet in GoFlow, and imports them. It does **not** push products from GoFlow to nocnoc — for that, see [Create new products in nocnoc](/goflow/create-listings). ## To enable listings import From the left sidebar, go to **Directory → Stores** and open your nocnoc store. On the **Status** card, find the **Listings Import** setting and click the pencil icon to edit. Set Listings Import to **Enabled** and click **Save**. Once enabled, GoFlow will check nocnoc for new products every few hours and import any that aren't already in GoFlow. This means whenever you or your account manager create new products on the nocnoc side, they'll automatically appear in GoFlow during the next sync. # Consolidate orders Source: https://nocnoc.mintlify.app/goflow/how-to-consolidate How to consolidate multiple nocnoc orders into a single master package in GoFlow. When shipping multiple nocnoc orders together, you can consolidate them into a single master package with one tracking number. This reduces shipping costs and simplifies your operation. ## How consolidation works 1. Download all the nocnoc labels (store carton labels) for the orders you want to consolidate 2. Print and attach each label to its corresponding individual package 3. Place all individual packages inside a single master box 4. Ship the master box and assign the same tracking number to every order in the consolidation ## Download nocnoc labels in bulk Go to the **Orders** section and select all the orders you want to consolidate. Click **Actions** in the toolbar. Click the three dots next to **Download Order Documents**, select **Store Carton Labels**, and click **Download**.