InfiPlex API Reference
The InfiPlex REST API connects your ERP, WMS, or custom application directly to your InfiPlex account. Pull orders from every connected marketplace, send tracking back, update inventory and pricing across all of your sales channels, and manage products, warehouses, and settings, all through one integration.
API calls run through InfiPlex exactly like actions taken in the OMS. Tracking you post is forwarded to the order's marketplace automatically, and inventory and price updates are queued to every connected channel with that sync enabled.
Getting Started
- API access is included with the Growth and Enterprise packages. See InfiPlex pricing.
- Contact InfiPlex Support for your API key and your API URL.
- In this collection, every request uses the
{{api_url}}variable. Set it to your API URL in your Postman environment. - Send every request with your API key in the
Authorizationheader, as shown below.
Authentication
The InfiPlex API uses Bearer token authentication. Send your API key in the Authorization header of every request:
Authorization: Bearer YOUR_API_KEY
Example request:
curl "YOUR_API_URL/shop/order/search?limit=10" -H "Authorization: Bearer YOUR_API_KEY"
Send the key in the header only, never in the URL.
Permissions
Each API key has separate read and write permissions for each area: Orders, Inventory, Prices, Products, PIM, Warehouses, Settings, Passthrough, and Amazon Today. A key only reaches the areas it has been granted, and a read-only key cannot change data. Ask InfiPlex Support to adjust the permissions on your key.
Requests and Responses
- OMS endpoints live under
{{api_url}}/shop/. - Request bodies and responses are JSON. Send
Content-Type: application/jsonon POST and PUT requests. - Date filters use the format
2018-01-01 10:10:10 AM. - Order endpoints take the InfiPlex order ID (
orderid), not the marketplace order number. Use Order Search to find an order by its marketplace number. - The bulk inventory, bin location, and product create endpoints take a JSON array as the body root, one object per item.
Syncing Orders
The standard integration loop:
- Pull orders: Order Search with
date_created_greater_equal_thanset to your last check, so you only pull new orders. Check for duplicates before inserting. - Send tracking: Order Tracking Create. InfiPlex forwards the tracking to the order's marketplace automatically.
- Send inventory: Inventory Set Bulk updates levels across your SKUs in one call.
Order PII (the ship-to address) is retained only for a limited time after the order is placed, per Amazon's data security requirements. Pull and store the order data you need promptly.
Pagination
Search endpoints return results in pages:
limit: results per page. Most search endpoints cap this at 100.limit_start: number of results to skip. Use0for the first page,100for the second page atlimit=100, and so on.- Keep paging until a page returns fewer results than your
limit. just_count=1returns only the number of matching records, with no results.
Error Codes
The InfiPlex API returns standard HTTP status codes. 2xx means success, 4xx means the request needs to be corrected, and 5xx means retry.
| Code | Meaning |
|---|---|
200 OK |
The request succeeded. |
201 Created |
The record was created. |
202 Accepted |
The request was accepted for processing. |
204 No Content |
The request succeeded and there is no body to return. |
400 Bad Request |
The request is malformed, or a required parameter is missing or invalid. |
401 Unauthorized |
The API key is missing or invalid. |
403 Forbidden |
The API key does not have permission for this call. |
404 Not Found |
The endpoint or the requested record does not exist. |
405 Method Not Allowed |
The HTTP method is not supported on this endpoint. |
429 Too Many Requests |
Too many requests in a short period. Wait, then retry with a longer delay each time. |
500 Internal Server Error |
An unexpected server error occurred. Retry, and contact support if it continues. |
503 Service Unavailable |
The service is temporarily unavailable. Retry after a short wait. |
Support
API support is included with every InfiPlex package, and our team answers developer questions on the API directly. Contact InfiPlex.
Related guides:
Authorization
Bearer token, sent in the Authorization header.
OMS / Shop
- Orders
- GET Order SearchSearches orders in InfiPlex OMS.
- GET Order GetReturns one complete order by its InfiPlex order ID: addresses, totals, status flags, line items with the warehouse each line was routed to, and every package shipped against it with tracking.
- GET Order Get Warehouse Routing ExplanationReturns the step-by-step record of how InfiPlex routed each item on an order to a warehouse: which warehouses were valid, which rules were checked, how much...
- PUT ProcessedSets or clears an order's processed flag.
- PUT CancelCancels an order. The order stays in InfiPlex, flagged canceled.
- PUT Update StatusSets an order's status.
- POST Order Note CreateCreates an internal note on an order.
- POST Order Additional Info CreateThis call creates a new additional info field for an order.
- POST Order CreateCreate an order
- POST Order Tracking CreateCreates a shipment on an existing order.
- Inventory
- GET Inventory GetReturns the current inventory for one SKU.
- GET Inventory Change History GetReturns the inventory changes recorded for one SKU, newest first.
- PUT Inventory SetChanges inventory for one SKU in one warehouse.
- POST Inventory Set BulkChanges inventory for many SKUs in one call.
- POST Bin Location SetSet the bin locatiSets the bin location for SKUs in one or more warehouses.
- GET Inventory SearchReturns inventory rows, one per SKU per warehouse.
- GET Inventory Restock ListReturns every parent product and child SKU whose total on-hand inventory, summed across all warehouses, is at or below its reorder point.
- GET Inventory Buffer SearchLists the Inventory Buffers on the account.
- GET Inventory Buffer GetGets one Inventory Buffer.
- Pricing
- GET Price GetGet inventory for a specific sku
- PUT Price SetSet pricing for a sku
- GET Price Search
- PIM
- GET PIM SKU GetGet PIM data for a specific sku
- GET PIM Nightly FileThis is used to download a specific PIM data file that automatically gets built every night by InfiPlex.
- Products
- POST Products CreateCreates new products, or updates the basic product information of SKUs that already exist.
- GET SKU Group SearchLists the SKU Inventory Groups on the account.
- GET SKU Group GetGets one SKU Inventory Group with every SKU in it.
- GET Bundle SearchLists the Bundles on the account.
- GET Bundle GetGets one Bundle with its component SKUs.
- GET Unknown SKU SearchLists the Unknown SKUs InfiPlex has recorded.
- GET SKU Map SearchLists the SKU Maps on the account.
- GET SKU Map GetGets one SKU Map with every SKU pair in it.
- Warehouse
- GET Warehouse GetReturns one warehouse's settings: its name, identifier, address, contact details, fulfillment order, service IDs, and its zip code rules along with whether they apply.
- PUT Warehouse SetUpdates an existing warehouse.
- POST Warehouse CreateCreates a new warehouse and returns its ID.
- GET Warehouse SearchReturns the warehouses on your account, with each warehouse's name, identifier, address, contact details, fulfillment order, service IDs, and zip code rules.
- Settings
- GET Shop Setting GetReturns the current value of one shop setting.
- PUT Shop Setting SetChanges the value of one shop setting.
- GET Setting SearchReturns every shop setting whose name or description contains the search term, with each setting's current value and a description of what it controls.
- Logs
- GET Shop Log Type ListReturns every shop log type on your account, as an object that maps each log type ID to its label.
- GET Shop Log SearchReturns entries from the shop log.
- Passthrough
- Amazon
- FBA
- GET Inventory SearchSearch for inventory in FBA
- Seller Central
- PUT Inventory SetMake a request to set inventory in Seller Central.
- FBA
- Amazon
- Amazon Today
- Inventory
- GET Inventory GetGet inventory for a specific sku
- PUT Inventory SetSet inventory for a sku
- POST Inventory Set BulkSet inventory for a sku
- POST Bin Location SetSet the bin location for a sku in a warehouses
- GET Inventory Search
- Velocity
- POST Order SearchThis call searches for Amazon Today orders in InfiPlex OMS and formats them based on a velocity format that is sent via the POST body The default response order...
- GET Order SearchThis call searches for Amazon Today orders in InfiPlex OMS
- GET Label SearchThis call gets a label for an Amazon Today order.
- PUT Order Confirm ReceiptThis call confirms order receipt for an Amazon Today order.
- PUT Order Confirm PickupThis call confirms order pickup for an Amazon Today order.
- PUT Order RejectThis call rejects an Amazon Today order.
- PUT Generate LabelThis call generates a label for an Amazon Today order.
- PUT Process ReturnThis call processes a return for an Amazon Today order.
- PUT Store ActionThis call controls executing actions against a store.
- Inventory
- Connection
- GET Fulfillment Item Bundle SearchLists the Item Bundle Groups on the account.
- GET Fulfillment Item Bundle GetGets one Item Bundle Group with every component line in it.
- GET Fulfillment ListLists every fulfillment connection that is turned on for the account, with its settings.
- GET Fulfillment Connection ProductsLists the products a fulfillment connection has reported to InfiPlex: the 3PL's or drop shipper's own view of the catalog, under the partner's SKUs, with the...
Data Bridge
- GET File Get
- GET File SearchThey query parameter 'search' is a JSON encoded array that allows advanced filtering of data bridge files.
