MAP violation check API

Checks a list of seller offers against a minimum-advertised-price floor (with optional tolerance), flagging violations, shortfall amounts, and the worst offender. Answers 'Which sellers are below MAP?', 'How far below the MAP floor is the worst offer?'.

Price$0.02per request

MethodPOST

Route/v1/commerce/map-check

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

commercemapminimum-advertised-pricecompliancepricingresellerviolationpolicy

API URLhttps://x402.hexl.dev/v1/commerce/map-check

Integration docs

Example request

{
  "map": 99.99,
  "offers": [
    {
      "seller": "x",
      "price": 99.99
    },
    {
      "seller": "y",
      "price": 89.99
    }
  ]
}

Example response

{
  "map": 99.99,
  "tolerance": 0,
  "enforcedFloor": 99.99,
  "offers": [
    {
      "seller": "x",
      "price": 99.99,
      "violation": false,
      "shortfall": 0,
      "shortfallPct": 0
    },
    {
      "seller": "y",
      "price": 89.99,
      "violation": true,
      "shortfall": 10,
      "shortfallPct": 10.001
    }
  ],
  "violationCount": 1,
  "compliant": false,
  "worstViolator": {
    "seller": "y",
    "price": 89.99,
    "violation": true,
    "shortfall": 10,
    "shortfallPct": 10.001
  },
  "interpretation": "1/2 offers below MAP floor $99.99; worst: y at $89.99."
}

Input schema

{
  "type": "object",
  "required": [
    "map",
    "offers"
  ],
  "properties": {
    "map": {
      "type": "number",
      "examples": [
        99.99
      ]
    },
    "offers": {
      "type": "array",
      "examples": [
        [
          {
            "seller": "x",
            "price": 99.99
          },
          {
            "seller": "y",
            "price": 89.99
          }
        ]
      ]
    },
    "tolerance": {
      "type": "number",
      "examples": [
        0
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}