--- title: "REST API: Get My Spaces" type: "wiki" space: "Axero Documentation" author: "Anonymous User" created: 2020-08-03T17:42:06Z updated: 2026-09-28T01:15:26Z tags: ["API"] url: "https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/66959/rest-api-get-my-spaces" --- # REST API: Get My Spaces [Open API Guide](https://my.axerosolutions.com/spaces/5/axero-documentation/api-guide?id=66959) GET/api/spaces/me List the published spaces the caller belongs to. The list is empty when spaces are switched off for the site. ## Request ### Request Header | Header | Required | Value | Description | | :--- | :--- | :--- | :--- | | `Authorization` | YES | `Bearer YOUR_TOKEN` | Bearer token for the authenticated user. [Learn how to create Bearer tokens](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/108973/creating-bearer-tokens). | ### Optional Parameters | Parameter | Type | Required | Location | Description | | :--- | :--- | :--- | :--- | :--- | | `AddTopLevelCommunity` | Boolean | NO | Query | Set to true to include the top level community \(SpaceID 0\) in the list. Default: false. A value that is not true or false is read as false. | | `SetHasManageSpacePerm` | Boolean | NO | Query | Set to true to include, on each space, whether the calling user can manage it. The same setting also returns ManageSpaceURL as a full address, including the site's domain. It changes every image address in each space's Description to a full address too. Default: false. A value that is not true or false is read as false. | | `IsMobile` | Boolean | NO | Query | Set to true to return the short list the mobile app uses: each space carries only SpaceID, SpaceName, SpaceIconURL, and SpaceVisibilityText, and SetHasManageSpacePerm is ignored. Default: false. A value that is not true or false is read as false. | ## Example ### Request Header ``` Authorization: Bearer YOUR_TOKEN ``` ### Request URL `https://your-site.com/api/spaces/me` ### Success Response ``` { "IsError": false, "ResponseMessage": "", "ResponseData": [ { "SpaceURL": "your-site.com/spaces/252/human-resources/hr-homepage", "SpaceName": "Human Resources", "SpaceImageURL": "your-site.com/Assets/Uploaded-CMS-Files/SpacesFiles/252/46283b79-6c58-4f71-8e13-e1414b688dd5.png", "Description": "A space dedicated to all your human resources needs and questions.", "SpaceID": 252, "ParentSpaceID": 0, "IsFeatured": false, "Stub": "human-resources", "LandingPage": "your-site.com/spaces/252/human-resources/hr-homepage", "TotalMembers": 102, "CreatedBy": 376, "UserID": 376, "UserName": "admin", "UserFirstName": "Alexis", "UserLastName": "Fox", "UserEmail": "admin@your-site.com", "StatusID": 1, "MembershipType": 1, "SpaceVisibility": 1, "DateCreated": "2026-01-01T12:00:00Z", "IsAttendee": false, "EventID": 0, "InviteSpaceID": 0, "WorkFlowID": 0, "CurrentWorkFlowStepID": 0, "IsArticleWorkflowActive": true, "IsBlogWorkflowActive": false, "IsEventWorkflowActive": false, "IsForumWorkflowActive": false, "IsWikiWorkflowActive": false, "IsFileWorkflowActive": false, "IsPhotoWorkFlowActive": false, "IsJobWorkflowActive": false, "IsVideoWorkFlowActive": false, "EnableForums": true, "EnableJobs": false, "EnableSurveys": true, "EnablePhotos": true, "EnableTaskManager": true, "EnableFiles": true, "EnableWiki": true, "EnableEvents": true, "EnableArticles": true, "EnableBlogs": true, "EnableVideos": true, "EnableIssueTracker": true, "EnableFileControl": false, "GroupPictureFileName": "46283b79-6c58-4f71-8e13-e1414b688dd5.png", "SpaceIconFileName": "46283b79-6c58-4f71-8e13-e1414b688dd5_icon.png", "SpaceIconURL": "your-site.com/Assets/Uploaded-CMS-Files/SpacesFiles/252/46283b79-6c58-4f71-8e13-e1414b688dd5_icon.png", "MediaServerID": 24, "SpaceMediaServerRootURL": "your-site.com/Assets/Uploaded-CMS-Files", "UserMediaServerRootURL": "your-site.com/Assets/Uploaded-Photos", "UserAvatarFileName": "f9c8486c-f3f3-41f9-9f46-044093247dc9.jpg", "UpdatedByUserID": 0, "InvitationExpiryInDays": 0, "DisableWallEmailNotifications": true, "AutoSubscribeEmail": true, "IsArticleCommentWorkflowActive": false, "IsBlogEntryCommentWorkflowActive": false, "IsEventCommentWorkflowActive": false, "IsForumPostWorkflowActive": false, "IsPhotoCommentWorkflowActive": false, "IsVideoCommentWorkflowActive": false, "IsWikiCommentWorkflowActive": false, "IsFileCommentWorkflowActive": false, "IsIdeaCommentWorkflowActive": false, "IsJobCommentWorkflowActive": false, "EnableUpcomingBirthdaysControl": true, "EnableContentReadConfirmation": true, "ManageSpaceURL": "your-site.com/spaces/252/human-resources/manage/default", "SpaceVisibilityText": "Public Space", "HasManageSpacePerm": true, "AutoSubscribeForums": true, "EnableCalendarImportFromExternalSources": false, "EnableEventsFromOtherSpacesInCalendar": true, "EnableContentExpiration": true, "EnableTaskRating": true, "ActivityURL": "your-site.com/spaces/252/human-resources/?act=1", "NewContentCount": 56 }, { "SpaceURL": "your-site.com/spaces/255/internal-communications", "SpaceName": "Internal Communications", "SpaceImageURL": "your-site.com/Assets/Uploaded-CMS-Files/SpacesFiles/255/83816c16-f571-4bd1-a2a5-3c95e1200c5b.png", "Description": "The space for accessing all of the company's internal communications.", "SpaceID": 252, "ParentSpaceID": 0, "IsFeatured": false, "Stub": "internal-communications", "LandingPage": "", "TotalMembers": 2, "CreatedBy": 376, "UserID": 376, "UserName": "admin", "UserFirstName": "Alexis", "UserLastName": "Fox", "UserEmail": "admin@your-site.com", "StatusID": 1, "MembershipType": 1, "SpaceVisibility": 1, "DateCreated": "2026-01-01T12:00:00Z", "IsAttendee": false, "EventID": 0, "InviteSpaceID": 0, "WorkFlowID": 0, "CurrentWorkFlowStepID": 0, "IsArticleWorkflowActive": false, "IsBlogWorkflowActive": false, "IsEventWorkflowActive": false, "IsForumWorkflowActive": false, "IsWikiWorkflowActive": false, "IsFileWorkflowActive": false, "IsPhotoWorkFlowActive": false, "IsJobWorkflowActive": false, "IsVideoWorkFlowActive": false, "EnableForums": true, "EnableJobs": false, "EnableSurveys": true, "EnablePhotos": true, "EnableTaskManager": true, "EnableFiles": true, "EnableWiki": true, "EnableEvents": true, "EnableArticles": true, "EnableBlogs": true, "EnableVideos": true, "EnableIssueTracker": true, "EnableFileControl": false, "GroupPictureFileName": "83816c16-f571-4bd1-a2a5-3c95e1200c5b.png", "SpaceIconFileName": "83816c16-f571-4bd1-a2a5-3c95e1200c5b_icon.png", "SpaceIconURL": "your-site.com/Assets/Uploaded-CMS-Files/SpacesFiles/255/83816c16-f571-4bd1-a2a5-3c95e1200c5b_icon.png", "MediaServerID": 24, "SpaceMediaServerRootURL": "your-site.com/Assets/Uploaded-CMS-Files", "UserMediaServerRootURL": "your-site.com/Assets/Uploaded-Photos", "UserAvatarFileName": "f9c8486c-f3f3-41f9-9f46-044093247dc9.jpg", "UpdatedByUserID": 0, "InvitationExpiryInDays": 0, "DisableWallEmailNotifications": false, "AutoSubscribeEmail": true, "IsArticleCommentWorkflowActive": false, "IsBlogEntryCommentWorkflowActive": false, "IsEventCommentWorkflowActive": false, "IsForumPostWorkflowActive": false, "IsPhotoCommentWorkflowActive": false, "IsVideoCommentWorkflowActive": false, "IsWikiCommentWorkflowActive": false, "IsFileCommentWorkflowActive": false, "IsIdeaCommentWorkflowActive": false, "IsJobCommentWorkflowActive": false, "EnableUpcomingBirthdaysControl": false, "EnableContentReadConfirmation": true, "HasManageSpacePerm": true, "AutoSubscribeForums": false, "EnableCalendarImportFromExternalSources": false, "EnableEventsFromOtherSpacesInCalendar": false, "EnableContentExpiration": false, "EnableTaskRating": false, "ActivityURL": "your-site.com/spaces/255/internal-communications", "NewContentCount": 133 }, { "SpaceURL": "your-site.com/spaces/256/information-technology", "SpaceName": "Information Technology", "SpaceImageURL": "your-site.com/Assets/Uploaded-CMS-Files/SpacesFiles/256/02704bbe-ef30-455a-8f31-3c0a242e6b3a.jpg", "Description": "Submit your help desk and tech questions here.", "SpaceID": 252, "ParentSpaceID": 0, "IsFeatured": false, "Stub": "information-technology", "LandingPage": "", "TotalMembers": 2, "CreatedBy": 376, "UserID": 376, "UserName": "admin", "UserFirstName": "Alexis", "UserLastName": "Fox", "UserEmail": "admin@your-site.com", "StatusID": 1, "MembershipType": 1, "SpaceVisibility": 1, "DateCreated": "2026-01-01T12:00:00Z", "IsAttendee": false, "EventID": 0, "InviteSpaceID": 0, "WorkFlowID": 0, "CurrentWorkFlowStepID": 0, "IsArticleWorkflowActive": false, "IsBlogWorkflowActive": false, "IsEventWorkflowActive": false, "IsForumWorkflowActive": false, "IsWikiWorkflowActive": false, "IsFileWorkflowActive": false, "IsPhotoWorkFlowActive": false, "IsJobWorkflowActive": false, "IsVideoWorkFlowActive": false, "EnableForums": true, "EnableJobs": false, "EnableSurveys": true, "EnablePhotos": true, "EnableTaskManager": true, "EnableFiles": true, "EnableWiki": true, "EnableEvents": true, "EnableArticles": true, "EnableBlogs": true, "EnableVideos": true, "EnableIssueTracker": true, "EnableFileControl": false, "GroupPictureFileName": "02704bbe-ef30-455a-8f31-3c0a242e6b3a.jpg", "SpaceIconFileName": "02704bbe-ef30-455a-8f31-3c0a242e6b3a_icon.jpg", "SpaceIconURL": "your-site.com/Assets/Uploaded-CMS-Files/SpacesFiles/256/02704bbe-ef30-455a-8f31-3c0a242e6b3a_icon.jpg", "MediaServerID": 24, "SpaceMediaServerRootURL": "your-site.com/Assets/Uploaded-CMS-Files", "UserMediaServerRootURL": "your-site.com/Assets/Uploaded-Photos", "UserAvatarFileName": "f9c8486c-f3f3-41f9-9f46-044093247dc9.jpg", "UpdatedByUserID": 0, "InvitationExpiryInDays": 0, "DisableWallEmailNotifications": false, "AutoSubscribeEmail": true, "IsArticleCommentWorkflowActive": false, "IsBlogEntryCommentWorkflowActive": false, "IsEventCommentWorkflowActive": false, "IsForumPostWorkflowActive": false, "IsPhotoCommentWorkflowActive": false, "IsVideoCommentWorkflowActive": false, "IsWikiCommentWorkflowActive": false, "IsFileCommentWorkflowActive": false, "IsIdeaCommentWorkflowActive": false, "IsJobCommentWorkflowActive": false, "EnableUpcomingBirthdaysControl": false, "EnableContentReadConfirmation": true, "HasManageSpacePerm": true, "AutoSubscribeForums": false, "EnableCalendarImportFromExternalSources": false, "EnableEventsFromOtherSpacesInCalendar": false, "EnableContentExpiration": false, "EnableTaskRating": false, "ActivityURL": "your-site.com/spaces/256/information-technology", "NewContentCount": 87 } ] } ``` ### Error Response ``` You do not have sufficient permissions to perform this action. ``` ## Error Handling | Status Code | Likely Cause | Next Action | | :--- | :--- | :--- | | 401 Unauthorized | Missing or invalid Bearer token. | Check token validity. [Learn how to create Bearer tokens →](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/108973/creating-bearer-tokens) | | 403 Forbidden | Not returned: no permission check refuses the request, so any signed-in caller gets 200. | No action needed for permissions. | | 500 Server Error | Internal failure. | Retry later. | ## Rate Limits While Axero does not enforce hard rate limits by default, we recommend the following best practices to ensure optimal performance: - **Sustained Request Rate:** Do not exceed 5 API calls per second - **Sequential Processing:** Wait for each request to complete before sending the next in automated workflows - **Concurrent Connections:** If parallel processing is required, limit to 3 or fewer simultaneous requests - **Response Timeout:** Ensure API responses complete within 15 seconds during testing Axero may implement temporary rate restrictions if excessive API usage affects overall site performance. For high-volume integrations, contact Axero to discuss your requirements.