API v1StableLast updated Oct 2026Changelog →
Flagship

Map

Turn incoming data into the exact shape your app expects.

Send source records and a target_schema. Map picks the best source per field (direct, alias, similarity, first+last combine, safe split), converts types, and explains each mapping with a confidence score.

POST /api/v1/map. Billed once per input record, up to 500 per request.

  • options.strict: only very high-confidence mappings
  • options.repair_before_mapping: run Repair first (still billed once)
  • options.drop_unmapped: default true

Types: string, integer, float, number, boolean, email, phone, url, date, datetime, currency, percentage, company, name, country, state, postal_code, identifier.

curl -X POST https://messyapi.com/api/v1/map \
  -H "Authorization: Bearer $MESSYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "records": [
    {
      "first_name": "Ana",
      "last_name": "Lima",
      "annualrevenue": "$1,200"
    }
  ],
  "target_schema": {
    "full_name": "name",
    "annual_revenue": "currency"
  }
}'