{"id":263788,"date":"2025-12-16T09:16:21","date_gmt":"2025-12-16T09:16:21","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/rest-api-menus\/"},"modified":"2026-06-30T07:02:25","modified_gmt":"2026-06-30T07:02:25","slug":"endpointy-menus","status":"publish","type":"plugin","link":"https:\/\/tt.wordpress.org\/plugins\/endpointy-menus\/","author":23298972,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.2.0","stable_tag":"1.2.0","tested":"7.0","requires":"5.0","requires_php":"","requires_plugins":null,"header_name":"EndPointy Menus","header_author":"Gunjan Jaswal","header_description":"Exposes WordPress menus via a custom REST API endpoint.","assets_banners_color":"344856","last_updated":"2026-06-30 07:02:25","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/ko-fi.com\/gunjanjaswal","header_plugin_uri":"https:\/\/github.com\/gunjanjaswal\/Endpointy-Menus","header_author_uri":"https:\/\/gunjanjaswal.me","rating":0,"author_block_rating":0,"active_installs":0,"downloads":354,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.1.0":{"tag":"1.1.0","author":"gunjanjaswal","date":"2025-12-16 09:17:28"},"1.1.1":{"tag":"1.1.1","author":"gunjanjaswal","date":"2026-05-21 10:22:38"},"1.2.0":{"tag":"1.2.0","author":"gunjanjaswal","date":"2026-06-30 07:02:25"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3424780,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3424778,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3424779,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500-es.png":{"filename":"banner-1544x500-es.png","revision":3424771,"resolution":"1544x500","location":"assets","locale":"es","width":1544,"height":500},"banner-1544x500-es_ES.png":{"filename":"banner-1544x500-es_ES.png","revision":3424772,"resolution":"1544x500","location":"assets","locale":"es_ES","width":1544,"height":500},"banner-1544x500-rtl.png":{"filename":"banner-1544x500-rtl.png","revision":3424773,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3424769,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250-es.png":{"filename":"banner-772x250-es.png","revision":3424766,"resolution":"772x250","location":"assets","locale":"es","width":772,"height":250},"banner-772x250-es_ES.png":{"filename":"banner-772x250-es_ES.png","revision":3424767,"resolution":"772x250","location":"assets","locale":"es_ES","width":772,"height":250},"banner-772x250-rtl.png":{"filename":"banner-772x250-rtl.png","revision":3424768,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3424765,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.0","1.1.1","1.2.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[141196,1118,231,1753,23853],"plugin_category":[43],"plugin_contributors":[245263],"plugin_business_model":[],"class_list":["post-263788","plugin","type-plugin","status-publish","hentry","plugin_tags-headless","plugin_tags-json","plugin_tags-menus","plugin_tags-navigation","plugin_tags-rest-api","plugin_category-customization","plugin_contributors-gunjanjaswal","plugin_committers-gunjanjaswal"],"banners":{"banner":"https:\/\/ps.w.org\/endpointy-menus\/assets\/banner-772x250.png?rev=3424765","banner_2x":"https:\/\/ps.w.org\/endpointy-menus\/assets\/banner-1544x500.png?rev=3424769","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/endpointy-menus\/assets\/icon.svg?rev=3424779","icon":"https:\/\/ps.w.org\/endpointy-menus\/assets\/icon.svg?rev=3424779","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>EndPointy Menus adds custom REST API routes to expose your WordPress navigation menus as JSON.<\/p>\n\n<p><strong>Base namespace:<\/strong> <code>endpointy-menus\/v1<\/code><\/p>\n\n<p><strong>Endpoints:<\/strong><\/p>\n\n<ul>\n<li><p><code>GET \/wp-json\/endpointy-menus\/v1\/menus<\/code>\nReturns all registered menus with locations and items.<\/p><\/li>\n<li><p><code>GET \/wp-json\/endpointy-menus\/v1\/menus\/&lt;id&gt;<\/code>\nReturns a single menu and its items by menu ID.<\/p><\/li>\n<li><p><code>GET \/wp-json\/endpointy-menus\/v1\/menus\/slug\/&lt;slug&gt;<\/code>\nReturns a single menu and its items by menu slug.<\/p><\/li>\n<li><p><code>GET \/wp-json\/endpointy-menus\/v1\/locations<\/code>\nReturns all registered menu locations with assigned menus.<\/p><\/li>\n<li><p><code>GET \/wp-json\/endpointy-menus\/v1\/locations\/&lt;location&gt;<\/code>\nReturns a menu assigned to a specific location (e.g., 'primary', 'footer').<\/p><\/li>\n<\/ul>\n\n<p><strong>Query Parameters:<\/strong><\/p>\n\n<ul>\n<li><p><code>nested=true<\/code> - Returns menu items in a hierarchical tree structure with parent-child relationships.\nExample: <code>\/wp-json\/endpointy-menus\/v1\/menus\/2?nested=true<\/code><\/p><\/li>\n<li><p><code>meta=true<\/code> - Adds extra item data: description, attr_title, current flag, featured image URL and post excerpt.\nExample: <code>\/wp-json\/endpointy-menus\/v1\/menus\/2?meta=true<\/code><\/p><\/li>\n<li><p><code>fields=id,title,url<\/code> - Returns only the listed fields per item (children are always kept in nested mode).\nExample: <code>\/wp-json\/endpointy-menus\/v1\/menus\/2?fields=id,title,url<\/code><\/p><\/li>\n<\/ul>\n\n<p>Parameters can be combined, e.g. <code>?nested=true&amp;meta=true&amp;fields=id,title,url,children<\/code>.<\/p>\n\n<p><strong>Settings (Settings \u2192 EndPointy Menus):<\/strong><\/p>\n\n<ul>\n<li>Response caching with a configurable lifetime (transients, auto-flushed when a menu is edited).<\/li>\n<li>Optional API-key protection via <code>X-API-Key<\/code> header or <code>api_key<\/code> query parameter.<\/li>\n<li>CORS allow-list for browser-based consumers.<\/li>\n<li>Per-IP rate limiting (requests\/minute) with X-RateLimit headers and 429 responses.<\/li>\n<li>ETag \/ Last-Modified conditional requests returning 304 Not Modified.<\/li>\n<\/ul>\n\n<p><strong>Developer hooks:<\/strong><\/p>\n\n<ul>\n<li><code>endpointy_menus_item<\/code> filter - modify each formatted menu item before output.<\/li>\n<\/ul>\n\n<p>This is useful for headless WordPress setups or any external app that needs to read your menu structure.<\/p>\n\n<h3>Usage<\/h3>\n\n<p>Example requests:<\/p>\n\n<p><strong>Get all menus:<\/strong>\n    https:\/\/your-site.com\/wp-json\/endpointy-menus\/v1\/menus<\/p>\n\n<p><strong>Get single menu by ID:<\/strong>\n    https:\/\/your-site.com\/wp-json\/endpointy-menus\/v1\/menus\/2<\/p>\n\n<p><strong>Get all menu locations:<\/strong>\n    https:\/\/your-site.com\/wp-json\/endpointy-menus\/v1\/locations<\/p>\n\n<p><strong>Get menu by location (e.g., 'primary'):<\/strong>\n    https:\/\/your-site.com\/wp-json\/endpointy-menus\/v1\/locations\/primary<\/p>\n\n<p><strong>Get nested menu structure:<\/strong>\n    https:\/\/your-site.com\/wp-json\/endpointy-menus\/v1\/menus\/2?nested=true\n    https:\/\/your-site.com\/wp-json\/endpointy-menus\/v1\/locations\/primary?nested=true<\/p>\n\n<p>Use these URLs directly from your front-end application or API client.<\/p>\n\n<h3>Support the Developer<\/h3>\n\n<p>If you find this plugin useful, you can support the developer:<\/p>\n\n<ul>\n<li>Website: https:\/\/gunjanjaswal.me<\/li>\n<li>GitHub: https:\/\/github.com\/gunjanjaswal\/Endpointy-Menus<\/li>\n<li>Ko-fi: https:\/\/ko-fi.com\/gunjanjaswal<\/li>\n<\/ul>\n\n<h3>Contributing<\/h3>\n\n<p>Contributions, issues, and feature requests are welcome!\nGitHub: https:\/\/github.com\/gunjanjaswal\/Endpointy-Menus\nIssues: https:\/\/github.com\/gunjanjaswal\/Endpointy-Menus\/issues<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>endpointy-menus<\/code> folder to your <code>wp-content\/plugins<\/code> directory.<\/li>\n<li>Activate <strong>EndPointy Menus<\/strong> from the Plugins screen in WordPress.<\/li>\n<li>Ensure you have at least one menu configured under <strong>Appearance \u2192 Menus<\/strong>.<\/li>\n<\/ol>\n\n<!--section=changelog-->\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Added admin settings page under Settings \u2192 EndPointy Menus.<\/li>\n<li>Added response caching (transients) with configurable lifetime and automatic flush on menu edits.<\/li>\n<li>Added optional API-key authentication (X-API-Key header or api_key query param).<\/li>\n<li>Added configurable CORS allow-list.<\/li>\n<li>Added per-IP rate limiting with X-RateLimit headers and 429 responses.<\/li>\n<li>Added ETag \/ Last-Modified conditional requests (304 Not Modified).<\/li>\n<li>Added <code>\/menus\/slug\/&lt;slug&gt;<\/code> endpoint to fetch a menu by slug.<\/li>\n<li>Added <code>meta=true<\/code> query parameter for description, featured image, excerpt and current flag.<\/li>\n<li>Added <code>fields=<\/code> query parameter to limit returned item fields.<\/li>\n<li>Added <code>endpointy_menus_item<\/code> filter for developers.<\/li>\n<li>Added menu item <code>count<\/code> to menu payloads and <code>menu_slug<\/code> to locations.<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Updated \"Tested up to\" to WordPress 7.0.<\/li>\n<li>Updated donation link to Ko-fi (https:\/\/ko-fi.com\/gunjanjaswal).<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Added support for filtering menus by location.<\/li>\n<li>Added nested menu hierarchy with <code>nested=true<\/code> query parameter.<\/li>\n<li>Added <code>\/locations<\/code> endpoint to list all menu locations.<\/li>\n<li>Added <code>\/locations\/&lt;location&gt;<\/code> endpoint to get menu by location.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Expose WordPress menus via a custom REST API endpoint for headless and external applications.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/263788","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tt.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tt.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=263788"}],"author":[{"embeddable":true,"href":"https:\/\/tt.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/gunjanjaswal"}],"wp:attachment":[{"href":"https:\/\/tt.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=263788"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=263788"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=263788"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=263788"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=263788"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=263788"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}