Bulk upsert Market Cost Prices

Create or upsert market cost prices in bulk (1–5000).

Use this for a batch price synchronization. Inspect the per-batch result and invalid codes before considering the import complete.

Behaviour

With mode: UPSERT existing full codes are updated (counted under updated); the market must be configured for the customer, or the row is reported in invalidCodes.

Currency is not accepted — it is derived from the market.

Each item is a full replacement: omitting rrp clears any stored RRP.

Requires the marketCostPrices:write scope.

post

Authorizations

AuthorizationstringRequired

API key sent as a bearer token (mk_live_… / mk_test_…).

Body

Data schema used by Bulk upsert Market Cost Prices (POST /v1/market-cost-prices:bulk). Read that operation for usage, permissions and update rules. Required fields and allowed values are defined below; request and response shapes can differ.

modestring · enumOptional

CREATE adds only (existing full codes are skipped); UPSERT updates them.

Default: CREATEPossible values:

Responses

200

Successful response.

application/json

400

Invalid request data.

application/json

401

Missing or invalid API key.

application/json

403

The API key lacks the required scope (scope_denied), or the operation is not permitted for this account (operation_not_permitted).

application/json

409

Conflict with the current state (e.g. the resource already exists).

application/json

429

The API key exceeded its request rate (rate_limit_exceeded) or its monthly quota (quota_exceeded). Both carry Retry-After; the RateLimit-* headers accompany rate_limit_exceeded only, since a spent quota says nothing about the bucket.

application/json

500

Internal server error.

application/json

post/v1/market-cost-prices:bulk

POST /v1/market-cost-prices:bulk HTTP/1.1
Host: admin.mimeeqapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "mode": "CREATE",
  "items": [
    {
      "market": "UK",
      "code": "A-TM1680/BE",
      "quantity": 1,
      "cost": 55.5,
      "rrp": 150
    }
  ]
}

{
  "data": {
    "existingCount": 1,
    "added": 1,
    "updated": 1,
    "unchanged": 1,
    "processed": 1,
    "invalidCodes": [
      "text"
    ],
    "skippedCodes": [
      "text"
    ]
  }
}