Umrah CodesBrowse Nusuk codes
  1. Home
  2. Open codes API

Open Nusuk codes API

The referral codes on Umrah Codes are free for any website or community initiative, with no sign-up or API key. Please link to the site as the source and follow the fair-use note.

Codes: 51,565Last updated: 2026-11-05 14:05 UTC

Available files

Every URL accepts GET requests from any origin (CORS enabled). https://umrahcodes.click/open-data/v1/

  • latest.jsonLatest 200 codes, for frequent refreshes 10 KB
  • codes.jsonAll codes with time added, newest first 2,463 KB
  • codes.csvAll codes as a spreadsheet 1,332 KB
  • codes.txtOne code per line 604 KB
  • meta.jsonUpdate time, count and file checksums

Examples

const res = await fetch('https://umrahcodes.click/open-data/v1/latest.json');
const data = await res.json();
console.log(data.count, data.updatedAt);
for (const { code } of data.codes) {
  const link = data.linkTemplate.replace('{code}', code);
  console.log(code, link);
}
import requests

data = requests.get("https://umrahcodes.click/open-data/v1/codes.json", timeout=30).json()
print(data["count"], data["updatedAt"])
for item in data["codes"][:5]:
    print(item["code"], item["addedAt"])
<?php
$data = json_decode(file_get_contents('https://umrahcodes.click/open-data/v1/latest.json'), true);
foreach (array_slice($data['codes'], 0, 5) as $item) {
    echo $item['code'], PHP_EOL;
}
curl -s https://umrahcodes.click/open-data/v1/codes.txt -o nusuk-codes.txt

Data format

Each item in codes has the code and the time it was added (Cairo time), or null if unknown. linkTemplate shows the link that opens a code in Nusuk.

{
  "schemaVersion": 1,
  "updatedAt": "2026-11-05T14:05:14.848Z",
  "count": 51565,
  "source": "https://umrahcodes.click/",
  "linkTemplate": "https://services.nusuk.sa/app/?p=27&id={code}",
  "pinned": {
    "code": "NG-pj62UbOJ",
    "note": "Initiative owner code, shown first on umrahcodes.click"
  },
  "codes": [
    {
      "code": "NG-pj62UbOJ",
      "addedAt": "2026-11-03 02:43"
    },
    {
      "code": "NG-Uq5nWX7P",
      "addedAt": null
    }
  ]
}

Fair use

Files update with each site update. Request each file at most once every 15 minutes and cache it; use the small meta.json to check for changes. If you show the codes on your site, please link to Umrah Codes.

Note

Codes are added by users and their validity in the Nusuk app is not guaranteed. This is an independent initiative, not affiliated with Nusuk or any government body.

For partnerships or code exchange between initiatives, contact us on WhatsApp.
Browse Nusuk codes

More guides

  • How do I find my Nusuk code?
  • Nusuk challenge keys
  • Nusuk code not working?
  • Nusuk Umrah competition

Codes come from visitors and from other open community initiatives that share Nusuk codes. An independent community project for exchanging Nusuk challenge codes. Not affiliated with the Nusuk app or any official organization.

Language

العربيةEnglishEspañolFrançais中文اردوBahasa Indonesiaहिन्दीবাংলাTürkçe
Back to home