List Market Cost Prices

List market cost prices for your customer.

Use this to reconcile market-specific price inputs. Narrow large datasets instead of treating the final page as proof that all records were retrieved.

Behaviour

Optionally filter by market or by search (a substring over the full code market|code|quantity).

Results are cursor-paginated.

At most 10000 records can be paged through.

page.totalRecords is how many your customer actually has (ignoring filters); when that exceeds what you can page through, page.truncated is true and reaching nextCursor: null still leaves records unseen.

Only search reaches them — it is applied before the cap, while market filters the records already returned.

Requires the marketCostPrices:read scope.

get

Authorizations

AuthorizationstringRequired

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

Query parameters

limitinteger · min: 1 · max: 5000Optional

Page size (1–5000, default 50).

Default: 50Example: 50

cursorstring · min: 1Optional

Pagination cursor returned as page.nextCursor.

searchstring · min: 1Optional

Substring match over the full code (market|code|quantity).

Example: A-TM1680

marketstring · min: 1 · max: 255Optional

Filter to a single market (case-insensitive).

Example: UK

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

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

get/v1/market-cost-prices

GET /v1/market-cost-prices HTTP/1.1
Host: admin.mimeeqapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "marketCostPriceId": "MCP-123e4567-e89b-12d3-a456-426614174000",
      "market": "text",
      "code": "text",
      "quantity": 1,
      "cost": 55.5,
      "rrp": 150,
      "currency": "£",
      "createdAt": "text",
      "modifiedAt": "text"
    }
  ],
  "page": {
    "limit": 1,
    "nextCursor": "text",
    "truncated": true,
    "totalRecords": 1
  }
}