Babele Logo

Projects

On this page, we'll dive into the different projects endpoints you can use to fetch projects programmatically.

POST/api/Project/GetByCommunity

List projects

This endpoint allows you to retrieve a paginated list of all your community's projects

Request body attributes

  • Name
    communityId
    Type
    integer
    Description

    The ID of your community.

  • Name
    take
    Type
    integer
    Description

    Limit the number of programs returned.

  • Name
    skip
    Type
    integer
    Description

    Specify the number of programs to skip.

Request

POST
/api/Project/GetByCommunity
curl -X POST https://api.babele.co/api/Project/GetByCommunity \
-H "Authorization: Bearer eyJhbGcgwgwe7gfwgwZZVCJ9.eyJTdWJqZWN0IjoiN2ZkMjc4YmUtMzA1Zi00ZWExLWJmODItNTQ5Yjg0NDBiM2E5IiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvc2lkIjoiYjE5ZDE0NWYtZDZiZC00Y2U5LTljYTQtYjFlOTgzNmRhODlhIiwidXBuIjoiNDAxMTQ0IiwiaHR0cDovL2JhYmVsZS5jby9jbGFpbXMvcGxhdGZvcm1hZG1pbmNsYWltIjoiRmFsc2UiLCJodHRwOi8vYmFiZWxlLmNvL2NsYWltcy9sb2dpbnJlcXFWFWGFQFsc2UiLCJuYmYiOjE3NDMyNjA0MDcsImV4cCI6MTc0Mzg2NTIwNywiaWF0IjoxNzQzMjYwNDA3fQ.K34301vGXSvFQC-5ypvDbfEr-L-uX57zw6GBjNa3sT4" \
-H "Content-Type: application/json" \
-d '{"skip":0,"take":50,"orderBy":5,"communityId":999}'

Response

{
"canCreateProjects": true,
"canInviteToProjects": true,
"canApproveParagraph": true,
"isCreateProjectsLocked": false,
"canAccessToOverviewProject": true,
"pendingProjects": [
    {
        "isFollowing": false,
        "canEditProjectInfo": false,
        "projectTags": [],
        "projectSustainableDevelopmentGoals": [],
        "isProjectTeamMember": false,
        "id": 8340,
        "name": "Vish",
        "description": "What if it's not a description",
        "logoImage": "/Images/Uploads/businessplan_logo/logo_202402091139399770_256x256.png",
        "isVideo": false,
        "websiteUrl": "",
        "mainImageOrVideo": "",
        "countryName": "Albania",
        "city": "Indore",
        "categoryName": "Ad Tech",
        "developmentStage": "default_development_stage_idea",
        "unGoalName": null,
        "viewCount": 0,
        "commentCount": 0,
        "loveCount": 0,
        "canInviteMembersAndMentorsFromOutside": true
    }
],
"projects": {
    "count": 168,
    "list": [
        {
            "isFollowing": false,
            "canEditProjectInfo": false,
            "projectTags": [],
            "projectSustainableDevelopmentGoals": [],
            "isProjectTeamMember": false,
            "id": 8464,
            "name": "Applied Startup",
            "description": "Applied Startup",
            "logoImage": "/Images/Uploads/businessplan_logo/croppedlogo_202503260943413072_256x256.png",
            "isVideo": false,
            "websiteUrl": "",
            "mainImageOrVideo": "/Images/Uploads/businessplan_logo/istockphotox_202409160831118642_1024x1024.jpg",
            "countryName": "Algeria",
            "city": "A",
            "categoryName": "Ag Tech",
            "developmentStage": "default_development_stage_idea",
            "unGoalName": null,
            "viewCount": 0,
            "commentCount": 0,
            "loveCount": 0,
            "canInviteMembersAndMentorsFromOutside": true
        },
        {
            "isFollowing": false,
            "canEditProjectInfo": false,
            "projectTags": [],
            "projectSustainableDevelopmentGoals": [
                {
                    "projectId": 8087,
                    "sustainableDevelopmentGoalId": 1
                }
            ],
            "isProjectTeamMember": false,
            "id": 8087,
            "name": "hey",
            "description": "hello",
            "logoImage": "/Images/Uploads/businessplan_logo/croppedlogo_202502171548010668_256x256.png",
            "isVideo": false,
            "websiteUrl": "",
            "mainImageOrVideo": "/Images/Uploads/businessplan_logo/croppedimage_202502171547466637_1024x1024.jpg",
            "countryName": "Albania",
            "city": "i",
            "categoryName": "Arts & Culture",
            "developmentStage": "",
            "unGoalName": null,
            "viewCount": 0,
            "commentCount": 0,
            "loveCount": 0,
            "canInviteMembersAndMentorsFromOutside": true
        },
        {
            "isFollowing": false,
            "canEditProjectInfo": false,
            "projectTags": [
                "appendTag1",
                "appendTag2",
                "cohort2021",
                "old_17"
            ],
            "projectSustainableDevelopmentGoals": [
                {
                    "projectId": 7898,
                    "sustainableDevelopmentGoalId": 1
                },
                {
                    "projectId": 7898,
                    "sustainableDevelopmentGoalId": 8
                },
                {
                    "projectId": 7898,
                    "sustainableDevelopmentGoalId": 3
                },
                {
                    "projectId": 7898,
                    "sustainableDevelopmentGoalId": 4
                }
            ],
            "isProjectTeamMember": false,
            "id": 7898,
            "name": "Manu's Icecream shop",
            "description": "People succeed v1",
            "logoImage": "/Images/Uploads/businessplan_logo/croppedlogo_202412110951571948_256x256.png",
            "isVideo": false,
            "websiteUrl": "https://www.facebook.com",
            "mainImageOrVideo": "/Images/Uploads/businessplan_logo/croppedimage_202412101338193888_1024x1024.jpg",
            "countryName": "Albania",
            "city": "Tirana",
            "categoryName": "Computer software and technology",
            "developmentStage": "",
            "unGoalName": null,
            "viewCount": 0,
            "commentCount": 0,
            "loveCount": 0,
            "canInviteMembersAndMentorsFromOutside": true
        }
    ],
    "filters": null
},
"projectFilters": {
    "countries": [
        {
            "name": "United States",
            "code": "US",
            "timezone": "America/New_York",
            "id": 196
        }
    ],
    "sustainableDevelopmentGoals": [
        {
            "name": "Affordable And Clean Energy",
            "iconName": "goals_icons-individual-rgb-07",
            "id": 7
        }
    ],
    "developmentStages": [
        "",
        "default_development_stage_idea",
        "default_development_stage_prototype",
        "default_development_stage_scaling",
        "default_development_stage_start_up"
    ],
    "industries": [
        {
            "name": "Ad Tech",
            "isAddedByUser": false,
            "id": 1365
        }
    ],
    "tags": [
        "tag1"
    ],
    "filters": [],
    "programs": [
        {
            "id": 542,
            "name": "Program Methodology"
        }
    ]
}
}
GET/api/ProjectTracking/SearchOverview?communityId={communityId}

Get projects overview

This endpoint allows you to get an overview of a project's progress, details and team members.

Required query parameters

  • Name
    communityId
    Type
    integer
    Description

    Your community ID

Request

POST
/api/ProjectTracking/SearchOverview?communityId={communityId}
curl -X GET https://api.babele.co/api/ProjectTracking/SearchOverview?communityId=999 \
-H "Authorization: Bearer eyJhbGcgwgwe7gfwgwZZVCJ9.eyJTdWJqZWN0IjoiN2ZkMjc4YmUtMzA1Zi00ZWExLWJmODItNTQ5Yjg0NDBiM2E5IiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvc2lkIjoiYjE5ZDE0NWYtZDZiZC00Y2U5LTljYTQtYjFlOTgzNmRhODlhIiwidXBuIjoiNDAxMTQ0IiwiaHR0cDovL2JhYmVsZS5jby9jbGFpbXMvcGxhdGZvcm1hZG1pbmNsYWltIjoiRmFsc2UiLCJodHRwOi8vYmFiZWxlLmNvL2NsYWltcy9sb2dpbnJlcXFWFWGFQFsc2UiLCJuYmYiOjE3NDMyNjA0MDcsImV4cCI6MTc0Mzg2NTIwNywiaWF0IjoxNzQzMjYwNDA3fQ.K34301vGXSvFQC-5ypvDbfEr-L-uX57zw6GBjNa3sT4" \
-H "Content-Type: application/json"

Response

{
"projectId": 9309,
"projectName": "Your Project Name",
"logoImage": "/Images/Uploads/logo.png",
"progress": 50,
"tags": [],
"projectCircles": [],
"projectUsers": [
    {
        "projectCircleId": 20046,
        "isPendingByUser": false,
        "isPendingByTeam": false,
        "requestedProjectCircleId": 123,
        "id": 12,
        "firstName": "Jane",
        "lastName": "Doe",
        "mail": "jane.doe@babele.co",
        "photo": "/Images/Uploads/profile_picture/croppedimage_202412191310431332_256x256.jpg",
        "occupation": "Project Manager",
        "biography": "<p>Project manager.</p>",
        "commentCount": 1009,
        "likeCount": 632,
        "followedUsersCount": 206,
        "activationCode": null,
        "activationCodeSent": null,
        "isProfileWizardDone": true,
        "countryId": 52,
        "country": null,
        "city": "Bucharest",
        "company": "Babele",
        "isBanned": false,
        "isActive": true,
        "invitationUrl": null,
        "language": "en-EN",
        "registrationDate": "0001-01-01T00:00:00Z",
        "lastLoginDate": "2025-01-09T10:54:35Z",
        "notificationEnabled": true,
        "primaryCommunityId": 241,
        "hasPendingRequests": null,
        "userInterests": null,
        "userSkills": null,
        "userSocial": null,
        "userMarketsExpertises": null,
        "userSustainableDevelopmentsGoals": null,
        "tags": null,
        "userTags": null,
        "termsAndConditionsVersion": 2,
        "photoUrl": "/Images/Uploads/profile_picture/croppedimage_202412191310431332_256x256.jpg",
        "facebookUrl": null,
        "twitterUrl": null,
        "googleUrl": null,
        "linkedInUrl": null,
        "isFollowedByMe": false
    }
],
"lastUpdate": "2024-12-19T11:37:09Z",
"stage": "Section 1",
"coachingSessions": 23,
"kpi": 5
}
GET/api/KPIReport/GetKpiChartReportsForOverview?communityId={communityId}

Get projects KPI progress

This endpoint allows you to retrieve the KPI progress of every project in your community.

Required query parameters

  • Name
    communityId
    Type
    integer
    Description

    Your community ID

Request

GET
/api/KPIReport/GetKpiChartReportsForOverview?communityId={communityId}
curl -X GET https://api.babele.co/api/KPIReport/GetKpiChartReportsForOverview?communityId=999 \
-H "Authorization: Bearer eyJhbGcgwgwe7gfwgwZZVCJ9.eyJTdWJqZWN0IjoiN2ZkMjc4YmUtMzA1Zi00ZWExLWJmODItNTQ5Yjg0NDBiM2E5IiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvc2lkIjoiYjE5ZDE0NWYtZDZiZC00Y2U5LTljYTQtYjFlOTgzNmRhODlhIiwidXBuIjoiNDAxMTQ0IiwiaHR0cDovL2JhYmVsZS5jby9jbGFpbXMvcGxhdGZvcm1hZG1pbmNsYWltIjoiRmFsc2UiLCJodHRwOi8vYmFiZWxlLmNvL2NsYWltcy9sb2dpbnJlcXFWFWGFQFsc2UiLCJuYmYiOjE3NDMyNjA0MDcsImV4cCI6MTc0Mzg2NTIwNywiaWF0IjoxNzQzMjYwNDA3fQ.K34301vGXSvFQC-5ypvDbfEr-L-uX57zw6GBjNa3sT4" \
-H "Content-Type: application/json"

Response

[
{
    "projectId": 7889,
    "kpiChartReport": [
        {
            "kpiDefinitionAndProjectName": "KPI 1 for Venture",
            "kpiDefinitionStartYear": 2023,
            "kpiDefinitionStartMonth": 6,
            "kpiDefinitionId": 274,
            "frequency": 1,
            "kpiValues": [],
            "methodologyId": 73,
            "isSurveyKPI": false
        },
        {
            "kpiDefinitionAndProjectName": "KPI 2 for Venture",
            "kpiDefinitionStartYear": 2024,
            "kpiDefinitionStartMonth": 5,
            "kpiDefinitionId": 430,
            "frequency": 1,
            "kpiValues": [],
            "methodologyId": 73,
            "isSurveyKPI": false
        },
        {
            "kpiDefinitionAndProjectName": "KPI 3 for Venture",
            "kpiDefinitionStartYear": 2023,
            "kpiDefinitionStartMonth": 5,
            "kpiDefinitionId": 277,
            "frequency": 12,
            "kpiValues": [],
            "methodologyId": 86,
            "isSurveyKPI": false
        },
        {
            "kpiDefinitionAndProjectName": "KPI 4 for Venture",
            "kpiDefinitionStartYear": 2023,
            "kpiDefinitionStartMonth": 6,
            "kpiDefinitionId": 276,
            "frequency": 1,
            "kpiValues": [],
            "methodologyId": 536,
            "isSurveyKPI": false
        },
        {
            "kpiDefinitionAndProjectName": "KPI 5 for Venture",
            "kpiDefinitionStartYear": 2023,
            "kpiDefinitionStartMonth": 7,
            "kpiDefinitionId": 420,
            "frequency": 1,
            "kpiValues": [
                {
                    "id": 1757,
                    "year": 2022,
                    "month": 3,
                    "value": 0.0
                },
                {
                    "id": 1758,
                    "year": 2022,
                    "month": 4,
                    "value": 0.0
                },
                {
                    "id": 1759,
                    "year": 2022,
                    "month": 5,
                    "value": 0.0
                },
                {
                    "id": 1760,
                    "year": 2022,
                    "month": 6,
                    "value": 0.0
                },
                {
                    "id": 1761,
                    "year": 2022,
                    "month": 7,
                    "value": 0.0
                },
                {
                    "id": 1762,
                    "year": 2022,
                    "month": 8,
                    "value": 0.0
                },
                {
                    "id": 1763,
                    "year": 2022,
                    "month": 9,
                    "value": 0.0
                },
                {
                    "id": 1764,
                    "year": 2022,
                    "month": 10,
                    "value": 0.0
                },
                {
                    "id": 1765,
                    "year": 2022,
                    "month": 11,
                    "value": 0.0
                },
                {
                    "id": 1766,
                    "year": 2022,
                    "month": 12,
                    "value": 0.0
                }
            ],
            "methodologyId": 234,
            "isSurveyKPI": false
        }
    ]
}
]
GET/api/Project/GetOverview?id={id}

Get a project overview

This endpoint returns the full overview payload for a single project — its descriptive content, media, social links, location, engagement counters, the team, pending paragraphs, tags, SDGs, KPI definitions and community-circle configuration. It also includes the calling user's permission flags (isCommunityAdmin, canEditProjectInfo, canEditProjectTeam, canEditCircles, canViewTasks) computed for that project. It backs the project overview/landing screen and the admin project view.

This is a large, expensive payload — it joins the team, discussions, KPIs and form answers. If the id does not resolve to a project, the service returns null with HTTP 200 (not a 404), so consumers must null-check the response body.

Required query parameters

  • Name
    id
    Type
    integer
    Description

    The ID of the project to retrieve.

Possible errors

  • Name
    401 Unauthorized
    Description

    The request is not authenticated.

Request

GET
/api/Project/GetOverview?id={id}
curl -X GET https://api.babele.co/api/Project/GetOverview?id=1714 \
-H "Authorization: Bearer eyJhbGcgwgwe7gfwgwZZVCJ9.eyJTdWJqZWN0IjoiN2ZkMjc4YmUtMzA1Zi00ZWExLWJmODItNTQ5Yjg0NDBiM2E5IiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvc2lkIjoiYjE5ZDE0NWYtZDZiZC00Y2U5LTljYTQtYjFlOTgzNmRhODlhIiwidXBuIjoiNDAxMTQ0IiwiaHR0cDovL2JhYmVsZS5jby9jbGFpbXMvcGxhdGZvcm1hZG1pbmNsYWltIjoiRmFsc2UiLCJodHRwOi8vYmFiZWxlLmNvL2NsYWltcy9sb2dpbnJlcXFWFWGFQFsc2UiLCJuYmYiOjE3NDMyNjA0MDcsImV4cCI6MTc0Mzg2NTIwNywiaWF0IjoxNzQzMjYwNDA3fQ.K34301vGXSvFQC-5ypvDbfEr-L-uX57zw6GBjNa3sT4" \
-H "Content-Type: application/json"

Response

{
"id": 1714,
"name": "Clean Water Initiative",
"description": "Bringing safe drinking water to rural communities.",
"logoImage": "/Images/Uploads/project_logo/clean-water.png",
"isVideo": false,
"websiteUrl": "https://cleanwater.example.org",
"mainImageOrVideo": "/Images/Uploads/project_main/clean-water-hero.jpg",
"countryName": "Romania",
"city": "Bucharest",
"latitude": 44.4268,
"longitude": 26.1025,
"categoryName": "Environment",
"developmentStage": "MVP",
"unGoalName": "Clean Water and Sanitation",
"viewCount": 1280,
"commentCount": 34,
"loveCount": 96,
"canInviteMembersAndMentorsFromOutside": true,
"isCommunityAdmin": true,
"canEditProjectInfo": true,
"canEditProjectTeam": true,
"canEditCircles": true,
"canViewTasks": true,
"isFollowing": false,
"isProjectTeamMember": true,
"isPendingByTeam": false,
"isPendingByUser": false,
"twitterUrl": "https://twitter.com/cleanwater",
"facebookUrl": "https://facebook.com/cleanwater",
"googleUrl": null,
"linkedInUrl": "https://linkedin.com/company/cleanwater",
"flickrUrl": null,
"twitterUrlSuffix": "cleanwater",
"facebookUrlSuffix": "cleanwater",
"googleUrlSuffix": null,
"linkedInUrlSuffix": "company/cleanwater",
"flickrUrlSuffix": null,
"discussionCount": 12,
"resourceCount": 8,
"networkCount": 5,
"methodologyId": 42,
"problemSolved": "Lack of access to safe drinking water.",
"ourSolution": "Low-cost solar water purification units.",
"measureImpact": "Litres of safe water delivered per month.",
"lastUpdated": "2026-06-20T14:05:00Z",
"userInvitationPolicy": 1,
"hideParagraphsUntilDate": false,
"countryId": 173,
"categoryId": 7,
"unGoalId": 6,
"projectModel": "Non-profit",
"pendingParagraphs": [],
"team": [
    {
        "id": 1,
        "firstName": "John",
        "lastName": "Doe",
        "mail": "john.doe@example.com",
        "photo": "/Images/Uploads/profile_picture/test.jpg",
        "occupation": "Founder",
        "isActive": true,
        "projectCircleId": 1,
        "photoUrl": "/Images/Uploads/profile_picture/test.jpg"
    }
],
"openDiscussions": [],
"projectTags": [
    "water",
    "sanitation"
],
"projectSustainableDevelopmentGoals": [
    {
        "projectId": 1714,
        "sustainableDevelopmentGoalId": 6
    }
],
"communityIds": [
    999
],
"mainCommunityId": 999,
"form": null,
"answers": [],
"kpiDefinitions": [],
"projectCommunityCircleList": [],
"projectCommunityUserCircleTagList": []
}