Dokumentasi API

curl "https://v1.api.my.id/holidays?year=2026"

{
  "status": "success",
  "code": 200,
  "year": 2026,
  "count": 25,
  "data": [
    {
      "date": "2026-08-17",
      "day": "Senin",
      "name": "Hari Kemerdekaan Republik Indonesia",
      "type": "national",
      "is_national": true,
      "is_cuti_bersama": false
    }
  ]
}

curl "https://v1.api.my.id/holidays/upcoming?limit=3"

curl "https://v1.api.my.id/holidays/check?date=2026-08-17"

{
  "status": "success",
  "code": 200,
  "data": {
    "date": "2026-08-17",
    "is_holiday": true,
    "holidays": [ { "name": "Hari Kemerdekaan Republik Indonesia", "type": "national", … } ]
  }
}

curl "https://v1.api.my.id/sholat?city=jakarta&date=2026-07-09"

{
  "status": "success",
  "code": 200,
  "data": {
    "city": { "slug": "jakarta", "name": "Jakarta", "lat": -6.2088, "lng": 106.8456 },
    "date": "2026-07-09",
    "timezone": "WIB",
    "gmt_offset": "+7",
    "jadwal": {
      "imsak": "04:31", "subuh": "04:41", "terbit": "06:04", "dhuha": "06:28",
      "dzuhur": "12:00", "ashar": "15:20", "maghrib": "17:53", "isya": "19:06"
    }
  }
}

curl "https://v1.api.my.id/sholat/cities"

{ "name": "Nama Anda", "email": "anda@perusahaan.com", "password": "min-8-karakter" }

curl -X POST "https://v1.api.my.id/auth/register" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Nama Anda", "email": "anda@perusahaan.com", "password": "min-8-karakter" }'

{
  "status": "success",
  "code": 201,
  "message": "Account created. Store this API key safely — it is shown only once.",
  "data": {
    "user": { "id": 1, "name": "Nama Anda", "email": "anda@perusahaan.com" },
    "api_key": "myid_live_a1b2c3d4e5f6…",
    "key_hint": "myid_live_a1b2…",
    "monthly_quota": 5000,
    "session_token": "…",
    "expires_at": "2026-08-11T00:00:00Z"
  }
}

{ "email": "anda@perusahaan.com", "password": "…" }

curl -X POST "https://v1.api.my.id/auth/login" \
  -H "Content-Type: application/json" \
  -d '{ "email": "anda@perusahaan.com", "password": "…" }'

{
  "status": "success",
  "code": 200,
  "message": "Signed in.",
  "data": { "user": { "id": 1, "email": "anda@perusahaan.com" }, "expires_at": "…" }
}

curl "https://v1.api.my.id/auth/me" \
  -H "Authorization: Session $SESSION_TOKEN"

{
  "status": "success",
  "code": 200,
  "data": {
    "user": { "id": 1, "name": "Nama Anda", "email": "anda@perusahaan.com" },
    "keys": [{ "id": 7, "key_hint": "myid_live_a1b2…", "points": 0 }],
    "points": 0,
    "monthly_quota": 5000
  }
}

curl -X POST "https://v1.api.my.id/auth/logout" \
  -H "Authorization: Session $SESSION_TOKEN"

{ "label": "Playground" }

curl -X POST "https://v1.api.my.id/keys/register" \
  -H "Authorization: Session $SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "label": "Playground" }'

{
  "status": "success",
  "code": 201,
  "message": "Store this key safely — it is shown only once.",
  "data": {
    "api_key": "myid_live_a1b2c3d4e5f6…",
    "key_hint": "myid_live_a1b2…",
    "label": "Playground",
    "monthly_quota": 5000
  }
}

{ "current_password": "…", "new_password": "min-8-karakter" }

curl -X POST "https://v1.api.my.id/auth/password" \
  -H "Authorization: Session $SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "current_password": "…", "new_password": "min-8-karakter" }'

{ "status": "success", "code": 200, "message": "Password changed. Every other session has been signed out." }

{ "name": "Nama Baru" }

curl -X POST "https://v1.api.my.id/auth/profile" \
  -H "Authorization: Session $SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Nama Baru" }'

curl -X POST "https://v1.api.my.id/auth/logout-all" \
  -H "Authorization: Session $SESSION_TOKEN"

curl -X DELETE "https://v1.api.my.id/keys/7" \
  -H "Authorization: Session $SESSION_TOKEN"

curl "https://v1.api.my.id/keys/me" \
  -H "Authorization: Bearer $API_KEY"

{
  "status": "success",
  "code": 200,
  "data": {
    "key_hint": "myid_live_a1b2…",
    "month": "2026-07",
    "quota": 5000,
    "used_this_month": 128,
    "remaining": 4872,
    "points": 50000,
    "active_subscriptions": [
      { "product_id": "wilayah-indonesia", "tier": "Pro", "monthly_quota": 25000, "expires_at": "2026-08-09T…" }
    ],
    "by_endpoint": [ { "endpoint": "wilayah/provinces", "hits": 40 } ]
  }
}

curl "https://v1.api.my.id/wilayah/provinces" \
  -H "Authorization: Bearer $API_KEY"

{
  "status": "success",
  "code": 200,
  "page": 1, "per_page": 100, "total": 34, "total_pages": 1, "count": 34,
  "data": [ { "code": "32", "name": "JAWA BARAT" } ]
}

curl "https://v1.api.my.id/wilayah/regencies?province=32" \
  -H "Authorization: Bearer $API_KEY"

curl "https://v1.api.my.id/wilayah/districts?regency=3204" \
  -H "Authorization: Bearer $API_KEY"

curl "https://v1.api.my.id/wilayah/villages?district=3204010" \
  -H "Authorization: Bearer $API_KEY"

curl "https://v1.api.my.id/wilayah/search?q=menteng" \
  -H "Authorization: Bearer $API_KEY"

{
  "status": "success", "code": 200, "query": "menteng", "count": 3,
  "data": [
    { "code": "3173020", "name": "MENTENG", "level": "district", "parent_code": "3173" },
    { "code": "3171090001", "name": "MENTENG DALAM", "level": "village", "parent_code": "3171090" }
  ]
}

curl "https://v1.api.my.id/schools?q=SMA Negeri 1&bentuk=SMA&status=N" \
  -H "Authorization: Bearer $API_KEY"

{
  "status": "success", "code": 200, "total": 749, "count": 1,
  "source": "Dapodik/Kemdikbud",
  "data": [
    {
      "npsn": "20106343", "name": "SMA NEGERI 1 CIAWIGEBANG", "bentuk": "SMA", "status": "N",
      "province": "Jawa Barat", "regency": "Kab. Kuningan", "district": "Ciawigebang",
      "address": "Jl. Siliwangi No. 1", "lat": -6.974, "lng": 108.5894
    }
  ]
}

curl "https://v1.api.my.id/universities?q=institut teknologi" \
  -H "Authorization: Bearer $API_KEY"

curl "https://v1.api.my.id/hospitals?type=RS Jiwa&province=32" \
  -H "Authorization: Bearer $API_KEY"

curl "https://v1.api.my.id/rates?base=USD&to=IDR&amount=100" \
  -H "Authorization: Bearer $API_KEY"

{
  "status": "success", "code": 200, "count": 1,
  "data": {
    "base": "USD",
    "updated_at": "Thu, 09 Jul 2026 00:02:32 +0000",
    "rates": { "IDR": 18058.21 },
    "converted": 1805821.08
  }
}

curl "https://v1.api.my.id/geocode/reverse?lat=-6.95&lng=107.60" \
  -H "Authorization: Bearer $API_KEY"

curl "https://v1.api.my.id/ip/8.8.8.8" \
  -H "Authorization: Bearer $API_KEY"

{
  "status": "success", "code": 200,
  "data": {
    "ip": "8.8.8.8", "country": "United States", "city": "Mountain View",
    "lat": 37.386, "lng": -122.084, "timezone": "America/Los_Angeles",
    "asn": 15169, "isp": "Google LLC"
  }
}

{ "origin": "3173020", "destination": "5103020", "weight": 1240, "courier": "jne,jnt" }

curl -X POST "https://v1.api.my.id/shipping/cost" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "origin": "3173020", "destination": "5103020", "weight": 1240, "courier": "jne,jnt" }'

{
  "status": "success",
  "code": 200,
  "origin": { "code": "3173020", "name": "Menteng" },
  "destination": { "code": "5103020", "name": "Kuta" },
  "weight_grams": 1240,
  "billed_weight": { "kg": 2, "note": "couriers bill per started kilogram, so the weight is rounded up" },
  "data": [
    { "courier": "jne", "service": "REG", "description": "Reguler", "cost": 19000, "etd": "2 day" },
    { "courier": "jne", "service": "YES", "description": "Express", "cost": 38000, "etd": "1 day" }
  ]
}

curl "https://v1.api.my.id/shipping/couriers" \
  -H "Authorization: Bearer $API_KEY"

{ "status": "success", "code": 200, "count": 9, "data": ["jne","pos","tiki","sicepat","jnt","ninja","anteraja","wahana","lion"] }

// multipart: field "image"  —  atau JSON:
{ "image": "<base64>", "media_type": "image/jpeg" }

curl -X POST "https://v1.api.my.id/ocr/ktp" \
  -H "Authorization: Bearer $API_KEY"

{
  "status": "success", "code": 200,
  "model": "claude-opus-4-8", "document": "ktp", "points_charged": 150,
  "data": {
    "nik": "3204xxxxxxxxxxxx", "nama": "BUDI SANTOSO",
    "tempat_lahir": "BANDUNG", "tanggal_lahir": "17-08-1990",
    "jenis_kelamin": "LAKI-LAKI", "alamat": "JL. MERDEKA NO. 1",
    "kecamatan": "COBLONG", "agama": "ISLAM",
    "confidence": "high"
  }
}

// multipart: field "image"  —  atau JSON base64

curl -X POST "https://v1.api.my.id/ocr/sim" \
  -H "Authorization: Bearer $API_KEY"

// multipart: field "file" (PDF atau gambar)
// atau JSON: { "text": "<isi CV>" }

curl -X POST "https://v1.api.my.id/cv/extract" \
  -H "Authorization: Bearer $API_KEY"

{
  "status": "success", "code": 200, "points_charged": 300,
  "data": {
    "name": "Siti Rahma", "email": "siti@example.com", "phone": "+62812…",
    "skills": ["Go", "PostgreSQL", "Docker"],
    "experience": [ { "company": "PT Maju", "title": "Backend Engineer", "start": "2022", "end": "2026", "description": "…" } ],
    "education": [ { "institution": "Institut Teknologi Bandung", "degree": "S1 Informatika", "year": "2021" } ],
    "certifications": [], "languages": ["Indonesia", "English"]
  }
}

{
  "topic": "Cara integrasi API cek ongkir",
  "language": "id",             // id | en
  "tone": "informatif",         // opsional
  "keywords": ["ongkir", "api"],// opsional, maks 10
  "words": 800                  // opsional, 300–2000
}

curl -X POST "https://v1.api.my.id/articles/generate" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "topic": "Cara integrasi API cek ongkir", "language": "id",             ,         , "api"],, maks 10 "words": 800                  , 300–2000 }'

{
  "status": "success", "code": 200, "points_charged": 1300,
  "data": {
    "article_markdown": "# Cara Integrasi API Cek Ongkir\n\n## Pendahuluan\n…",
    "meta_description": "Panduan lengkap integrasi API cek ongkir…",
    "word_count": 812
  }
}

// multipart: field "image" (maks 10 MB)

curl -X POST "https://v1.api.my.id/image/remove-bg?model=u2net&format=binary" \
  -H "Authorization: Bearer $API_KEY"

curl "https://v1.api.my.id/billing/config"

{ "amount": 100000 }   // IDR, 10.000 – 10.000.000

curl -X POST "https://v1.api.my.id/billing/topup" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 100000 }   , 10.000 – 10.000.000'

{
  "status": "success", "code": 200,
  "data": {
    "order_id": "TOPUP-12-1752…",
    "snap_token": "66e4fa55-fdac-4ef9-91b5-…",
    "redirect_url": "https://app.sandbox.midtrans.com/snap/v2/vtweb/…",
    "amount": 100000, "points": 100000
  }
}

{ "product_id": "wilayah-indonesia", "tier": "Pro" }

curl -X POST "https://v1.api.my.id/billing/subscribe" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "product_id": "wilayah-indonesia", "tier": "Pro" }'

curl "https://v1.api.my.id/billing/orders" \
  -H "Authorization: Bearer $API_KEY"