Skip to main content
GET
/
api
/
v1
/
menus
/
:id.json
Get Menu
curl --request GET \
  --url https://api.launchmystore.io/api/v1/menus/:id.json \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "id": "<string>",
    "title": "<string>",
    "handle": "<string>",
    "links": [
      {
        "id": "<string>",
        "title": "<string>",
        "url": "<string>",
        "type": "<string>",
        "resource_id": "<string>",
        "position": 123,
        "links": [
          {}
        ]
      }
    ],
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt

Use this file to discover all available pages before exploring further.

Get Menu

Returns a single navigation menu by its ID, including all links and nested children.

Request

curl -X GET "https://api.launchmystore.io/api/v1/menus/menu_abc123.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Path Parameters

id
string
required
The unique menu ID

Response

success
boolean
Whether the request succeeded
data
object
Menu object

Example Response

{
  "success": true,
  "data": {
    "id": "menu_abc123",
    "title": "Main Menu",
    "handle": "main-menu",
    "links": [
      {
        "id": "link_001",
        "title": "Home",
        "url": "/",
        "type": "http",
        "resource_id": null,
        "position": 1,
        "links": []
      },
      {
        "id": "link_002",
        "title": "Shop",
        "url": "/collections/all",
        "type": "collection",
        "resource_id": "col_all",
        "position": 2,
        "links": [
          {
            "id": "link_003",
            "title": "New Arrivals",
            "url": "/collections/new-arrivals",
            "type": "collection",
            "resource_id": "col_new",
            "position": 1,
            "links": []
          },
          {
            "id": "link_004",
            "title": "Best Sellers",
            "url": "/collections/best-sellers",
            "type": "collection",
            "resource_id": "col_best",
            "position": 2,
            "links": []
          }
        ]
      },
      {
        "id": "link_005",
        "title": "About",
        "url": "/pages/about-us",
        "type": "page",
        "resource_id": "page_about",
        "position": 3,
        "links": []
      },
      {
        "id": "link_006",
        "title": "Contact",
        "url": "/pages/contact",
        "type": "page",
        "resource_id": "page_contact",
        "position": 4,
        "links": []
      }
    ],
    "created_at": "2024-01-01T10:00:00Z",
    "updated_at": "2024-03-15T14:30:00Z"
  }
}

Error Codes

CodeDescription
UNAUTHORIZEDInvalid or missing access token
FORBIDDENApp doesn’t have read_content scope
NOT_FOUNDMenu with the specified ID does not exist