Get NuORDER Field Mappings
GET/api/nuorder/instances/:integrationInstance/products/field-mappings
The NuORDER → SKU.io field mappings used when SKU.io products are created from NuORDER sizes (Create SKU.io Product from NuORDER Product and the bulk create_products action). default_mappings are the built-in rules (derived SKU → SKU, title → product name, UPC → barcode, Wholesale Price → the wholesale pricing tier, Retail Price → the Retail tier or, without one, the default tier; when both resolve to the same tier only the wholesale row is kept), custom_mappings are the ones saved for this instance, and effective_mappings is the result (a custom mapping replaces the default for the same SKU.io field). available_listing_fields lists the NuORDER fields a mapping can read and available_sku_fields the SKU.io fields it can write (including every pricing tier and product attribute).
products:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
The wholesale tier is the oldest active tier whose name contains "wholesale". Without one, an archived wholesale tier is used as it is (never unarchived; no price is stored on it until the merchant unarchives it, and it is listed as Pricing: <name> (archived)). Without either, the target is price.Wholesale.value, listed as Pricing: Wholesale (new): the Wholesale tier is created only when a SKU.io product is actually created from a size — reading this endpoint or syncing products never creates it. The default derived SKU replaces spaces inside the style, colour and size with hyphens (ST1-Navy-Blue-10).
Authentication: Bearer token (Personal Access Token).
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.