curl -s "https://navvo.io/api/v1/billing/plans" \
  -H "x-api-key: nvvo_YOUR_KEY"

{
  "provider": "navvo-billing",
  "currency": "JOD",
  "plans": [
    {
      "key": "free",
      "name": "Free",
      "tagline": "For prototypes and side projects",
      "currency": "JOD",
      "monthlyPriceMinor": 0,
      "includedRequests": 50000,
      "overagePerThousandMinor": 0,
      "rateLimitPerMin": 60,
      "rateLimitPerDay": 5000,
      "features": ["search", "geocoding", "places", "map-tiles"]
    },
    {
      "key": "starter",
      "name": "Starter",
      "tagline": "For early-stage products going live",
      "currency": "JOD",
      "monthlyPriceMinor": 29000,
      "includedRequests": 500000,
      "overagePerThousandMinor": 400,
      "rateLimitPerMin": 300,
      "rateLimitPerDay": 100000,
      "features": ["search", "geocoding", "places", "map-tiles", "routing", "traffic"]
    },
    {
      "key": "growth",
      "name": "Growth",
      "tagline": "For scaling teams with real traffic",
      "currency": "JOD",
      "monthlyPriceMinor": 149000,
      "includedRequests": 5000000,
      "overagePerThousandMinor": 250,
      "rateLimitPerMin": 1200,
      "rateLimitPerDay": 1000000,
      "features": ["search", "geocoding", "places", "map-tiles", "routing", "traffic", "matrix", "fleet", "imagery"]
    },
    {
      "key": "enterprise",
      "name": "Enterprise",
      "tagline": "Custom volume, SLA, and data licensing",
      "currency": "JOD",
      "monthlyPriceMinor": null,
      "includedRequests": null,
      "overagePerThousandMinor": null,
      "rateLimitPerMin": null,
      "rateLimitPerDay": null,
      "features": ["all", "data-licensing", "priority-support", "dedicated-tiles"]
    }
  ]
}

curl -s "https://navvo.io/api/v1/me/entitlements" \
  -H "Authorization: Bearer USER_JWT"

{
  "provider": "navvo-entitlements",
  "entitlements": [
    "navvo_plus",
    "offline_maps",
    "atlas_advanced",
    "hazard_alerts"
  ],
  "plus": true,
  "subscriptions": [
    {
      "id": "sub_9f3a21",
      "product": "navvo_plus",
      "status": "active",
      "currency": "JOD",
      "priceMinor": 3500,
      "interval": "month",
      "renewsAt": "2026-07-19T00:00:00Z"
    }
  ]
}

curl -s "https://navvo.io/api/v1/ads/promoted?bbox=35.85,31.90,36.00,32.00&categories=restaurant,cafe" \
  -H "x-api-key: nvvo_YOUR_KEY"

{
  "provider": "navvo-ads",
  "type": "promoted_pin",
  "count": 1,
  "ads": [
    {
      "id": "ad_promo_8821",
      "type": "promoted_pin",
      "placeId": "plc_amman_cafe_4410",
      "title": "Rumi Café — Abdali",
      "subtitle": "Specialty coffee · Open now",
      "imageUrl": "https://navvo.io/ads/img/ad_promo_8821.jpg",
      "ctaUrl": "https://navvo.io/go?ref=RUMI-ABDALI",
      "lat": 31.9568,
      "lng": 35.9098,
      "sponsored": true
    }
  ]
}

curl -s "https://navvo.io/api/v1/ads/sponsored-search?q=coffee" \
  -H "x-api-key: nvvo_YOUR_KEY"

{
  "provider": "navvo-ads",
  "type": "sponsored_search",
  "count": 1,
  "ads": [
    {
      "id": "ad_search_5530",
      "type": "sponsored_search",
      "placeId": "plc_amman_cafe_4410",
      "title": "Rumi Café",
      "subtitle": "Sponsored · Specialty coffee in Abdali",
      "imageUrl": "https://navvo.io/ads/img/ad_search_5530.jpg",
      "ctaUrl": "https://navvo.io/go?ref=RUMI-SEARCH",
      "lat": 31.9568,
      "lng": 35.9098,
      "sponsored": true
    }
  ]
}

curl -s "https://navvo.io/api/v1/ads/atlas-card?q=where%20can%20I%20get%20coffee%20nearby" \
  -H "x-api-key: nvvo_YOUR_KEY"

{
  "provider": "navvo-ads",
  "type": "atlas_card",
  "ad": {
    "id": "ad_atlas_2207",
    "type": "atlas_card",
    "placeId": "plc_amman_cafe_4410",
    "title": "Rumi Café",
    "subtitle": "Specialty coffee · 400 m away · Open now",
    "imageUrl": "https://navvo.io/ads/img/ad_atlas_2207.jpg",
    "ctaUrl": "https://navvo.io/go?ref=RUMI-ATLAS",
    "lat": 31.9568,
    "lng": 35.9098,
    "sponsored": true
  }
}

curl -s -X POST "https://navvo.io/api/v1/ads/ad_promo_8821/click" \
  -H "x-api-key: nvvo_YOUR_KEY"

{
  "ok": true,
  "ctaUrl": "https://navvo.io/go?ref=RUMI-ABDALI",
  "chargedMinor": 180
}

{ "targeting": { "categories": ["restaurant"], "autoBid": { "enabled": true, "maxBidMinor": 250 } } }

{
  "ok": true, "id": "ad_promo_8821",
  "autoBid": { "enabled": true, "maxBidMinor": 250 },
  "baseBidMinor": 100, "pacingMultiplier": 1.8, "pCtr": 0.05,
  "effectiveBidMinor": 180, "auctionScore": 9.0, "remainingBudgetMinor": 9000
}

curl -s -X POST "https://navvo.io/api/v1/business/claims" \
  -H "Authorization: Bearer USER_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "placeId": "plc_amman_cafe_4410",
    "evidence": "رخصة مهن رقم 445871 مسجَّلة باسم شركة مقهى الرومي",
    "evidenceType": "trade_license",
    "evidenceUrls": { "license": "https://example.com/license.pdf" }
  }'

{
  "id": "clm_1f2e3d",
  "placeId": "plc_amman_cafe_4410",
  "status": "pending",
  "evidenceType": "trade_license",
  "createdAt": "2026-07-02T09:30:00Z"
}

curl -s "https://navvo.io/api/v1/business/claims" \
  -H "Authorization: Bearer USER_JWT"

curl -s -X POST "https://navvo.io/api/v1/business/campaigns" \
  -H "Authorization: Bearer USER_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "placeId": "plc_amman_cafe_4410",
    "name": "حملة القهوة المثلّجة الصيفية",
    "targeting": { "categories": ["cafe"], "autoBid": { "enabled": true, "maxBidMinor": 250 } }
  }'

{
  "id": "cmp_77aa",
  "placeId": "plc_amman_cafe_4410",
  "name": "حملة القهوة المثلّجة الصيفية",
  "status": "draft",
  "targeting": { "categories": ["cafe"], "autoBid": { "enabled": true, "maxBidMinor": 250 } },
  "createdAt": "2026-07-02T09:31:00Z"
}

curl -s "https://navvo.io/api/v1/business/campaigns?placeId=plc_amman_cafe_4410" \
  -H "Authorization: Bearer USER_JWT"

curl -s -X POST "https://navvo.io/api/v1/business/ai-copy" \
  -H "Authorization: Bearer USER_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "placeId": "plc_amman_cafe_4410",
    "context": { "highlights": ["قهوة مختصة", "جلسة على السطح"], "tone": "ودّي", "offer": "خصم 10% قبل العاشرة صباحاً" }
  }'

{
  "model": "navvo-copywriter",
  "unavailable": false,
  "purpose": "business_copy",
  "content": "AR: قهوة مختصة على السطح في قلب العبدلي — خصم ١٠٪ قبل العاشرة صباحًا.\nEN: Rooftop specialty coffee in the heart of Abdali — 10% off before 10am."
}

curl -s "https://navvo.io/api/v1/business/markers?bbox=35.85,31.90,36.00,32.00&zoom=14&category=restaurants" \
  -H "x-api-key: nvvo_YOUR_KEY"

{
  "limit": 60,
  "zoom": 14,
  "category": "restaurants",
  "categoryFiltered": true,
  "performance": {
    "requestedLimit": null, "limit": 60, "zoom": 14,
    "candidateCount": 118, "returnedCount": 60,
    "serverCapped": false, "resultCapped": true, "capReason": "zoom-limit"
  },
  "items": [
    {
      "id": "745cd311-887e-40ed-989d-94f7cb4d8f51",
      "slug": "rumi-cafe-abdali-4410",
      "nameEn": "Rumi Café",
      "nameAr": "مقهى الرومي",
      "canonicalCategorySlug": "restaurants",
      "categories": ["restaurants"],
      "rawCategories": ["Coffee shop"],
      "categoryStyle": {
        "source": "admin_map_categories",
        "slug": "restaurants",
        "color": "#F97316",
        "iconName": "pin",
        "pinStyle": "circle",
        "zoomRange": { "min": 12, "max": 20 },
        "visibility": { "map": true, "nearby": true, "searchFilters": true }
      },
      "claimStatus": "verified",
      "sponsored": true,
      "rating": 4.6,
      "lng": 35.9098,
      "lat": 31.9568
    }
  ]
}

curl -s "https://navvo.io/api/v1/places/rumi-cafe-abdali-4410/entrances" \
  -H "x-api-key: nvvo_YOUR_KEY"

[
  {
    "id": "ent_9a01",
    "type": "main",
    "label": "الباب الرئيسي — جهة شارع الرينبو",
    "notes": "دون درجات. مدخل المواقف بعد 40 متراً شرقاً.",
    "location": "POINT(35.9099 31.9569)"
  }
]

curl -s -X POST "https://navvo.io/api/v1/places/rumi-cafe-abdali-4410/entrances" \
  -H "Authorization: Bearer USER_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "parking",
    "label": "مدخل مواقف السيارات",
    "notes": "الحد الأقصى للارتفاع 2.1 متر",
    "lat": 31.9571,
    "lng": 35.9103
  }'

# عرض أساطيلك
curl -s "https://navvo.io/api/v1/fleet" \
  -H "Authorization: Bearer USER_JWT"

# إنشاء أسطول
curl -s -X POST "https://navvo.io/api/v1/fleet" \
  -H "Authorization: Bearer USER_JWT" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Amman City Couriers", "city": "Amman" }'

# إنشاء مهمة توصيل مع دفع نقدي عند الاستلام
curl -s -X POST "https://navvo.io/api/v1/fleet/flt_amman_01/tasks" \
  -H "Authorization: Bearer USER_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "Rainbow Street, Amman",
    "lat": 31.9515,
    "lng": 35.9239,
    "recipient": "Layla H.",
    "phone": "+962790000000",
    "codAmountMinor": 12500,
    "codCurrency": "JOD"
  }'

# ترتيب توقّفات سائق المعلَّقة بأقرب جار من نقطة بداية
curl -s -X POST "https://navvo.io/api/v1/fleet/flt_amman_01/optimize" \
  -H "Authorization: Bearer USER_JWT" \
  -H "Content-Type: application/json" \
  -d '{ "start": { "lat": 31.9539, "lng": 35.9106 }, "driverId": "drv_77" }'

# السائق يَسِم مهمة بأنها مُسلَّمة، والنقد محصَّل، مع دليل
curl -s -X PATCH "https://navvo.io/api/v1/fleet/tasks/tsk_5521/status" \
  -H "Authorization: Bearer USER_JWT" \
  -H "Content-Type: application/json" \
  -d '{ "status": "delivered", "codCollected": true, "proofUrl": "https://navvo.io/pod/tsk_5521.jpg" }'

curl -s "https://navvo.io/api/v1/fleet/flt_amman_01/cod-reconciliation" \
  -H "Authorization: Bearer USER_JWT"

{
  "provider": "navvo-fleet", "fleetId": "flt_amman_01", "currency": "JOD",
  "totals": { "collectedMinor": 142500, "outstandingMinor": 38000, "discrepancyMinor": 5000, "failedMinor": 9000, "codTasks": 37 },
  "drivers": [
    { "driverId": "drv_12", "name": "Sami",
      "collectedMinor": 100000, "outstandingMinor": 7000, "discrepancyMinor": 5000, "failedMinor": 0,
      "collectedCount": 8, "outstandingCount": 1, "discrepancyCount": 1 }
  ]
}

{
  "provider": "navvo-fleet", "fleetId": "flt_amman_01", "driverCount": 3,
  "drivers": [
    { "rank": 1, "driverId": "drv_2", "name": "Lina", "status": "online",
      "delivered": 6, "failed": 2, "canceled": 0, "active": 1,
      "successRate": 0.75, "avgDeliveryMinutes": 30, "codReliability": 1, "score": 450 },
    { "rank": 2, "driverId": "drv_1", "name": "Sami",
      "delivered": 4, "failed": 0, "successRate": 1, "avgDeliveryMinutes": 20, "score": 400 }
  ]
}

# عرض مجموعات البيانات والصيغ القابلة للترخيص (محصورة بالمسؤول)
curl -s "https://navvo.io/api/v1/admin/data-licensing/datasets" \
  -H "x-api-key: nvvo_YOUR_KEY"

# تصدير نقاط إشارات الطرق بصيغة SQL لمنطقة عرض
curl -s "https://navvo.io/api/v1/admin/data-licensing/export?dataset=signs&format=sql&bbox=35.85,31.90,36.00,32.00" \
  -H "x-api-key: nvvo_YOUR_KEY"

curl -s "https://navvo.io/api/v1/admin/privacy/density?source=signs&epsilon=1&minCount=5&zoom=13" \
  -H "x-api-key: nvvo_YOUR_KEY"

{
  "provider": "navvo-privacy", "type": "FeatureCollection", "source": "signs",
  "epsilon": 1, "minCount": 5, "gridZoom": 13, "pointsSampled": 412, "cells": 23,
  "features": [
    { "type": "Feature", "geometry": { "type": "Point", "coordinates": [35.925, 31.933] }, "properties": { "count": 19 } }
  ]
}

curl -s -i "https://navvo.io/api/v1/go?ref=RUMI-ABDALI"