Learn the base URL, rate limits, caching and error codes of the free Bila UiTM Cuti API, then make your first UiTM calendar request.
This is an unofficial API and is not affiliated with UiTM. Verify important dates before production use.
At a Glance
Methods — GET only
Auth — No API key
Rate limits — 500/min per endpoint path; +60/min heavy (all=true, allSessions=true); /api/health and /mcp/health excluded; X-RateLimit-* + RateLimit headers on responses
Caching — ETag + Cache-Control; If-None-Match for 304
Base URL
https://api.bilauitmcuti.com
Authentication
No API key required. Send unauthenticated GET requests.
Rate Limits
Production enforces per-IP limits via Cloudflare Workers Rate Limiting (per edge location):
500 requests / 60 seconds per endpoint path (separate counters per path).
60 requests / 60 seconds additional heavy bucket when all=true on calendar/meta, or allSessions=true on calendar.
GET /api/health and GET /mcp/health are not rate limited.
Cacheable successes include RateLimit-Policy (per-client remaining is omitted so shared caches cannot replay another client’s quota). 429 responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, RateLimit, RateLimit-Policy, and window-aligned Retry-After / JSON retryAfter. Use GET /api/v1/rate-limit for a best-effort remaining peek.
Rate-Limit Status
GET/api/v1/rate-limitReturns published policies and a best-effort remaining quota for the caller. This call does not consume rate-limit budget. Optional pathname selects which route to inspect (defaults to this endpoint). Optional heavy=true includes the heavy bucket in the primary view.
Query Parameters
Name
Type
Description
Example
pathname
string
API path to inspect. Must start with /. Defaults to /api/v1/rate-limit.
/api/v1/calendar
heavy
string
When true (or “1”/“yes”), response highlights the heavy bucket alongside endpoint policy.
true
Response Fields
Field
Type
Description
Example
enforcement
string
How limits are applied. Remaining is per edge isolate and approximate.
Cloudflare Workers Rate Limiting (per edge location). Remaining counts are approximate per worker isolate and do not consume quota on this endpoint.
pathname
string
Path being inspected.
/api/v1/calendar
heavyMode
boolean
Whether the heavy bucket is highlighted.
false
policies
object[]
Published endpoint (500 / 60s) and heavy (60 / 60s) policies.
Errors: validation 400; rate limits 429; missing session 404 on calendar and lecture-weeks.
Agent Skills
The bilauitmcuti-api agent skill teaches coding assistants how to call this API — endpoints, query parameters, ETags, and rate limits — in one short reference.Why use it: agents guess less. They pick the right paths, send required session / group params, and respect caching and rate-limit headers instead of inventing URLs from partial context.How to use: see the Skill page for install steps, or install directly from bilauitmcuti/skills in Cursor or another agent that supports skills. Also listed on skills.sh.
Model Context Protocol (MCP)
Claude, Grok, Grok Bot, or Cursor can use read-only MCP at https://mcp.bilauitmcuti.com/mcp (hosted Streamable HTTP). Same calendar and holiday data as the REST API; nothing gets written. MCP Server.
Contact and Feedback
Questions about the API, product feedback, or reports of wrong or mismatched calendar data — email [email protected] or send a message on Threads threads.com/@bilauitmcuti.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bila UiTM Cuti API","description":"Free public REST API and MCP server for the UiTM academic calendar (Group A and B), lecture weeks and Malaysia public holidays. No API key required.","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/bilauitmcuti/Zdep9_w44BTGtTDa/favicon.png?fit=max\u0026auto=format\u0026n=Zdep9_w44BTGtTDa\u0026q=85\u0026s=a5914adab4d916ffa356614c4acbd6d7","dark":"https://mintcdn.com/bilauitmcuti/Zdep9_w44BTGtTDa/favicon.png?fit=max\u0026auto=format\u0026n=Zdep9_w44BTGtTDa\u0026q=85\u0026s=a5914adab4d916ffa356614c4acbd6d7"},"favicon":"https://mintcdn.com/bilauitmcuti/Zdep9_w44BTGtTDa/favicon.png?fit=max\u0026auto=format\u0026n=Zdep9_w44BTGtTDa\u0026q=85\u0026s=a5914adab4d916ffa356614c4acbd6d7","api":{"openapi":"openapi.json","playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","prefill":false,"autogenerate":true},"url":"full"},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"},{"href":"https://status.bilauitmcuti.com","label":"Status"}],"primary":{"type":"github","href":"https://github.com/bilauitmcuti"}},"footer":{"socials":{"website":"https://bilauitmcuti.com ","github":"https://github.com/bilauitmcuti","linkedin":"https://www.linkedin.com/company/bilauitmcuti"}},"seo":{"metatags":{"robots":"index, follow","language":"en","keywords":"UiTM academic calendar API, UiTM cuti, kalendar akademik UiTM, Malaysia public holidays API, cuti umum Malaysia, lecture weeks, REST API, OpenAPI, MCP server","og:site_name":"Bila UiTM Cuti API Docs","og:type":"website","og:locale":"en_MY","twitter:card":"summary_large_image","twitter:image:alt":"Bila UiTM Cuti API documentation","og:title":"Bila UiTM Cuti API Docs","og:description":"Free public REST API and MCP server for the UiTM academic calendar, lecture weeks and Malaysia public holidays.","og:image":"https://bilauitmcuti.com/docs/images/ogimage-api.png","og:image:width":"1200","og:image:height":"630","og:image:alt":"Bila UiTM Cuti API documentation","twitter:title":"Bila UiTM Cuti API Docs","twitter:description":"Free public REST API and MCP server for the UiTM academic calendar, lecture weeks and Malaysia public holidays.","twitter:image":"https://bilauitmcuti.com/docs/images/ogimage-api.png"},"organization":{"id":"https://bilauitmcuti.com/#organization","name":"Bila UiTM Cuti","url":"https://bilauitmcuti.com","logo":"https://bilauitmcuti.com/docs/favicon.png","sameAs":["https://github.com/bilauitmcuti"]},"indexing":"navigable"},"fonts":{"heading":{"family":"Geist"},"body":{"family":"Geist"}},"icons":{"library":"lucide"},"contextual":{"options":["view","download-spec","mcp","claude","cursor"],"display":"header"},"thumbnails":{"preset":"minimal"},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bilauitmcuti","hasAudioNarration":false,"actualSubdomain":"bilauitmcuti","customDomains":["docs.bilauitmcuti.com"],"gitSource":{"type":"github","owner":"bilauitmcuti","repo":"api","deployBranch":"master","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":"","_id":"6aec35808342ca4a0131767f"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6aeff7ff9b06b349588e321f","clientVersion":"0.0.4149","searchFilterCounts":[{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"API Reference","count":10},{"language":"default","tag":"UiTM Academic Calendar","count":4},{"language":"default","tag":"System","count":4},{"language":"default","tag":"Overview","count":4},{"language":"default","tag":"AI Integrations","count":4},{"language":"default","tag":"Endpoints","count":2},{"language":"default","tag":"Malaysia Public Holidays","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"getting-started","slug":"/getting-started","pageMetadata":{"title":"Getting Started","sidebarTitle":"Getting Started","description":"Learn the base URL, rate limits, caching and error codes of the free Bila UiTM Cuti API, then make your first UiTM calendar request.","keywords":["UiTM API","getting started","base URL","rate limits","no API key","ETag caching"],"og:title":"Getting Started","og:description":"Base URL, rate limits and caching for the free UiTM academic calendar and Malaysia public holidays API. No API key needed.","og:image":"https://bilauitmcuti.com/docs/images/ogimage-api.png","twitter:image":"https://bilauitmcuti.com/docs/images/ogimage-api.png","href":"/getting-started"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Learn the base URL, rate limits, caching and error codes of the free Bila UiTM Cuti API, then make your first UiTM calendar request.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:`This is an unofficial API and is not affiliated with UiTM. Verify important dates before production use.`}),`\n`,_jsx(Heading,{level:`2`,id:`at-a-glance`,children:`At a Glance`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Methods`}),` — `,_jsx(_components.code,{children:`GET`}),` only`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Auth`}),` — No API key`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Rate limits`}),` — 500/min per endpoint path; +60/min heavy (`,_jsx(_components.code,{children:`all=true`}),`, `,_jsx(_components.code,{children:`allSessions=true`}),`); `,_jsx(_components.code,{children:`/api/health`}),` and `,_jsx(_components.code,{children:`/mcp/health`}),` excluded; `,_jsx(_components.code,{children:`X-RateLimit-*`}),` + `,_jsx(_components.code,{children:`RateLimit`}),` headers on responses`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Caching`}),` — ETag + Cache-Control; If-None-Match for 304`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`base-url`,children:`Base URL`}),`\n`,_jsx(_components.p,{children:_jsx(_components.code,{children:`https://api.bilauitmcuti.com`})}),`\n`,_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsxs(_components.p,{children:[`No API key required. Send unauthenticated `,_jsx(_components.code,{children:`GET`}),` requests.`]}),`\n`,_jsx(Heading,{level:`2`,id:`rate-limits`,children:`Rate Limits`}),`\n`,_jsx(_components.p,{children:`Production enforces per-IP limits via Cloudflare Workers Rate Limiting (per edge location):`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`500 requests / 60 seconds`}),` per endpoint path (separate counters per path).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`60 requests / 60 seconds`}),` additional heavy bucket when `,_jsx(_components.code,{children:`all=true`}),` on calendar/meta, or `,_jsx(_components.code,{children:`allSessions=true`}),` on calendar.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /api/health`}),` and `,_jsx(_components.code,{children:`GET /mcp/health`}),` are `,_jsx(_components.strong,{children:`not`}),` rate limited.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Cacheable successes include `,_jsx(_components.code,{children:`RateLimit-Policy`}),` (per-client remaining is omitted so shared caches cannot replay another client’s quota). `,_jsx(_components.code,{children:`429`}),` responses include `,_jsx(_components.code,{children:`X-RateLimit-Limit`}),`, `,_jsx(_components.code,{children:`X-RateLimit-Remaining`}),`, `,_jsx(_components.code,{children:`X-RateLimit-Reset`}),`, `,_jsx(_components.code,{children:`RateLimit`}),`, `,_jsx(_components.code,{children:`RateLimit-Policy`}),`, and window-aligned `,_jsx(_components.code,{children:`Retry-After`}),` / JSON `,_jsx(_components.code,{children:`retryAfter`}),`. Use `,_jsx(_components.code,{children:`GET /api/v1/rate-limit`}),` for a best-effort remaining peek.`]}),`\n`,_jsx(Heading,{level:`2`,id:`rate-limit-status`,children:`Rate-Limit Status`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET`}),` `,_jsx(_components.code,{children:`/api/v1/rate-limit`})]}),`\n`,_jsxs(_components.p,{children:[`Returns published policies and a best-effort remaining quota for the caller. This call does `,_jsx(_components.strong,{children:`not`}),` consume rate-limit budget. Optional `,_jsx(_components.code,{children:`pathname`}),` selects which route to inspect (defaults to this endpoint). Optional `,_jsx(_components.code,{children:`heavy=true`}),` includes the heavy bucket in the primary view.`]}),`\n`,_jsx(Heading,{level:`4`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Example`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pathname`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`API path to inspect. Must start with `,_jsx(_components.code,{children:`/`}),`. Defaults to `,_jsx(_components.code,{children:`/api/v1/rate-limit`}),`.`]}),_jsx(_components.td,{children:`/api/v1/calendar`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`heavy`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`When true (or “1”/“yes”), response highlights the heavy bucket alongside endpoint policy.`}),_jsx(_components.td,{children:`true`})]})]})]}),`\n`,_jsx(Heading,{level:`4`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Example`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`enforcement`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`How limits are applied. Remaining is per edge isolate and approximate.`}),_jsx(_components.td,{children:`Cloudflare Workers Rate Limiting (per edge location). Remaining counts are approximate per worker isolate and do not consume quota on this endpoint.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pathname`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Path being inspected.`}),_jsx(_components.td,{children:`/api/v1/calendar`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`heavyMode`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`Whether the heavy bucket is highlighted.`}),_jsx(_components.td,{children:`false`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`policies`})}),_jsx(_components.td,{children:`object[]`}),_jsxs(_components.td,{children:[`Published `,_jsx(_components.code,{children:`endpoint`}),` (500 / 60s) and `,_jsx(_components.code,{children:`heavy`}),` (60 / 60s) policies.`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`[{ \"name\": \"endpoint\", \"limit\": 500, \"period\": 60 }]`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`endpoint`})}),_jsx(_components.td,{children:`object`}),_jsxs(_components.td,{children:[`Snapshot: `,_jsx(_components.code,{children:`limit`}),`, `,_jsx(_components.code,{children:`remaining`}),`, `,_jsx(_components.code,{children:`reset`}),`, `,_jsx(_components.code,{children:`retryAfter`}),`.`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"name\": \"endpoint\", \"limit\": 500, \"remaining\": 499 }`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`heavy`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`Same shape for the heavy bucket.`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"name\": \"heavy\", \"limit\": 60, \"remaining\": 60 }`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`how-to-start`,children:`How to Start`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Call `,_jsx(_components.a,{href:`/academic-calendar`,children:`Sessions \u0026 Programs (Meta)`}),` for session options; `,_jsx(_components.a,{href:`/public-holidays`,children:`Public Holiday Options (Meta)`}),` for holiday filters.`]}),`\n`,_jsxs(_components.li,{children:[`Request `,_jsx(_components.a,{href:`/academic-calendar`,children:`Calendar Activities`}),`, `,_jsx(_components.a,{href:`/academic-calendar`,children:`Lecture Weeks (1-14)`}),`, or `,_jsx(_components.a,{href:`/public-holidays`,children:`Malaysia Public Holidays`}),` data.`]}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.a,{href:`/playground`,children:`Playground`}),` to test live.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Errors:`}),` validation 400; rate limits 429; missing session 404 on calendar and lecture-weeks.`]}),`\n`,_jsx(Heading,{level:`2`,id:`agent-skills`,children:`Agent Skills`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`bilauitmcuti-api`}),` agent skill teaches coding assistants how to call this API — endpoints, query parameters, ETags, and rate limits — in one short reference.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Why use it:`}),` agents guess less. They pick the right paths, send required `,_jsx(_components.code,{children:`session`}),` / `,_jsx(_components.code,{children:`group`}),` params, and respect caching and rate-limit headers instead of inventing URLs from partial context.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`How to use:`}),` see the `,_jsx(_components.a,{href:`/skill`,children:`Skill`}),` page for install steps, or install directly from `,_jsx(_components.a,{href:`https://github.com/bilauitmcuti/skills`,children:`bilauitmcuti/skills`}),` in Cursor or another agent that supports skills. Also listed on `,_jsx(_components.a,{href:`https://skills.sh/bilauitmcuti/skills`,children:`skills.sh`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`model-context-protocol-mcp`,children:`Model Context Protocol (MCP)`}),`\n`,_jsxs(_components.p,{children:[`Claude, Grok, Grok Bot, or Cursor can use read-only MCP at `,_jsx(_components.code,{children:`https://mcp.bilauitmcuti.com/mcp`}),` (hosted Streamable HTTP). Same calendar and holiday data as the REST API; nothing gets written. `,_jsx(_components.a,{href:`/mcp-server`,children:`MCP Server`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`contact-and-feedback`,children:`Contact and Feedback`}),`\n`,_jsxs(_components.p,{children:[`Questions about the API, product feedback, or reports of wrong or mismatched calendar data — email `,_jsx(_components.a,{href:`mailto:[email protected]`,children:`[email protected]`}),` or send a message on Threads `,_jsx(_components.a,{href:`https://www.threads.com/@bilauitmcuti`,children:`threads.com/@bilauitmcuti`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Getting Started","sidebarTitle":"Getting Started","description":"Learn the base URL, rate limits, caching and error codes of the free Bila UiTM Cuti API, then make your first UiTM calendar request.","keywords":["UiTM API","getting started","base URL","rate limits","no API key","ETag caching"],"og:title":"Getting Started","og:description":"Base URL, rate limits and caching for the free UiTM academic calendar and Malaysia public holidays API. No API key needed.","og:image":"https://bilauitmcuti.com/docs/images/ogimage-api.png","twitter:image":"https://bilauitmcuti.com/docs/images/ogimage-api.png","href":"/getting-started"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"At a Glance","slug":"at-a-glance","depth":2,"children":[]},{"title":"Base URL","slug":"base-url","depth":2,"children":[]},{"title":"Authentication","slug":"authentication","depth":2,"children":[]},{"title":"Rate Limits","slug":"rate-limits","depth":2,"children":[]},{"title":"Rate-Limit Status","slug":"rate-limit-status","depth":2,"children":[{"title":"Query Parameters","slug":"query-parameters","depth":4,"children":[]},{"title":"Response Fields","slug":"response-fields","depth":4,"children":[]}]},{"title":"How to Start","slug":"how-to-start","depth":2,"children":[]},{"title":"Agent Skills","slug":"agent-skills","depth":2,"children":[]},{"title":"Model Context Protocol (MCP)","slug":"model-context-protocol-mcp","depth":2,"children":[]},{"title":"Contact and Feedback","slug":"contact-and-feedback","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"bilauitmcuti","siteName":"Bila UiTM Cuti API","title":"Getting Started","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-08T04:18:10.749Z","originalFileLocation":"getting-started.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Learn the base URL, rate limits, caching and error codes of the free Bila UiTM Cuti API, then make your first UiTM calendar request.\">\u003cmeta data-mint-head name=\"keywords\" content=\"UiTM academic calendar API, UiTM cuti, kalendar akademik UiTM, Malaysia public holidays API, cuti umum Malaysia, lecture weeks, REST API, OpenAPI, MCP server\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bila UiTM Cuti API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintcdn.com/bilauitmcuti/Zdep9_w44BTGtTDa/favicon.png?fit=max\u0026amp;auto=format\u0026amp;n=Zdep9_w44BTGtTDa\u0026amp;q=85\u0026amp;s=a5914adab4d916ffa356614c4acbd6d7\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintcdn.com/bilauitmcuti/Zdep9_w44BTGtTDa/favicon.png?fit=max\u0026amp;auto=format\u0026amp;n=Zdep9_w44BTGtTDa\u0026amp;q=85\u0026amp;s=a5914adab4d916ffa356614c4acbd6d7\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintcdn.com/bilauitmcuti/Zdep9_w44BTGtTDa/favicon.png?fit=max\u0026amp;auto=format\u0026amp;n=Zdep9_w44BTGtTDa\u0026amp;q=85\u0026amp;s=a5914adab4d916ffa356614c4acbd6d7\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://mintcdn.com/bilauitmcuti/Zdep9_w44BTGtTDa/favicon.png?fit=max\u0026amp;auto=format\u0026amp;n=Zdep9_w44BTGtTDa\u0026amp;q=85\u0026amp;s=a5914adab4d916ffa356614c4acbd6d7\">\u003cmeta data-mint-head property=\"og:title\" content=\"Getting Started\">\u003cmeta data-mint-head property=\"og:description\" content=\"Base URL, rate limits and caching for the free UiTM academic calendar and Malaysia public holidays API. No API key needed.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bila UiTM Cuti API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bilauitmcuti.com/getting-started\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bilauitmcuti.com/docs/images/ogimage-api.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Bila UiTM Cuti API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Free public REST API and MCP server for the UiTM academic calendar, lecture weeks and Malaysia public holidays.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bilauitmcuti.com/docs/images/ogimage-api.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/bilauitmcuti/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bila UiTM Cuti API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_MY\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003cmeta data-mint-head name=\"twitter:image:alt\" content=\"Bila UiTM Cuti API documentation\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Bila UiTM Cuti API documentation\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bilauitmcuti.com/getting-started\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/getting-started.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://bilauitmcuti.com/#organization\",\"name\":\"Bila UiTM Cuti\",\"url\":\"https://bilauitmcuti.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://bilauitmcuti.com/docs/favicon.png\"},\"sameAs\":[\"https://github.com/bilauitmcuti\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bilauitmcuti.com#website\",\"name\":\"Bila UiTM Cuti API\",\"url\":\"https://docs.bilauitmcuti.com\",\"publisher\":{\"@id\":\"https://bilauitmcuti.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bilauitmcuti.com/getting-started#webpage\",\"url\":\"https://docs.bilauitmcuti.com/getting-started\",\"name\":\"Getting Started\",\"description\":\"Learn the base URL, rate limits, caching and error codes of the free Bila UiTM Cuti API, then make your first UiTM calendar request.\",\"dateModified\":\"2026-11-08T04:18:10.749Z\",\"isPartOf\":{\"@id\":\"https://docs.bilauitmcuti.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bilauitmcuti.com/getting-started#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bilauitmcuti.com/getting-started#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Bila UiTM Cuti API\",\"item\":\"https://docs.bilauitmcuti.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Getting Started\",\"item\":\"https://docs.bilauitmcuti.com/getting-started\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.bilauitmcuti.com/getting-started#article\",\"headline\":\"Getting Started\",\"name\":\"Getting Started\",\"description\":\"Learn the base URL, rate limits, caching and error codes of the free Bila UiTM Cuti API, then make your first UiTM calendar request.\",\"url\":\"https://docs.bilauitmcuti.com/getting-started\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bilauitmcuti.com/getting-started#webpage\"},\"image\":\"https://bilauitmcuti.com/docs/images/ogimage-api.png\",\"dateModified\":\"2026-11-08T04:18:10.749Z\",\"keywords\":\"UiTM API, getting started, base URL, rate limits, no API key, ETag caching\",\"publisher\":{\"@id\":\"https://bilauitmcuti.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bilauitmcuti.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bila UiTM Cuti API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bila UiTM Cuti\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/getting-started.md","siteName":"Bila UiTM Cuti API","nav":{"global":null,"tabs":[{"tab":"Guides","groups":[{"group":"Overview","pages":[{"title":"Getting Started","sidebarTitle":"Getting Started","href":"/getting-started"},{"title":"OpenAPI Specification","sidebarTitle":"OpenAPI Specification","description":"Download the OpenAPI 3 spec for the Bila UiTM Cuti API to import into Postman or Insomnia, or to generate typed API clients.","href":"/openapi-specification"},{"title":"Playground","sidebarTitle":"Playground","href":"/playground"},{"title":"Browse Datasets","sidebarTitle":"Browse Datasets","href":"/catalogue"}]},{"group":"Endpoints","pages":[{"title":"UiTM Academic Calendar","sidebarTitle":"UiTM Academic Calendar","href":"/academic-calendar"},{"title":"Malaysia Public Holidays","sidebarTitle":"Malaysia Public Holidays","href":"/public-holidays"}]},{"group":"AI Integrations","pages":[{"title":"MCP Server","sidebarTitle":"MCP Server","href":"/mcp-server"},{"title":"Agent skill for the UiTM calendar API","sidebarTitle":"Skill","href":"/skill"},{"title":"Privacy Policy","sidebarTitle":"Privacy Policy","href":"/mcp-server/privacy"},{"title":"Terms of Use","sidebarTitle":"Terms of Use","href":"/mcp-server/terms"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/meta"}]}]},"basePath":"","title":"Getting Started","buildId":"dpl_4D8r1dHg6bQcRuBgQyL3z9waJJtn","deploymentId":"dpl_4D8r1dHg6bQcRuBgQyL3z9waJJtn","dynamics":[],"chunks":[]}