---
updatedAt: 2026-05-27T11:17:14.000Z
agentTools:
  projectIndex: https://developer.unloc.app/llms.txt
---

# Get all Projects in Organization

Returns all <Glossary>Project</Glossary>s owned by this Organization.

| | |
| --- | --- |
| Required Scope | `organization.admin` |


# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Unloc API",
    "version": "2.0",
    "description": "The Unloc API allows you to fully manage your Organizations and the belonging Projects.\n\nGetting started:\n\n1. Contact us to make an Organization and API Credentials for you. Make sure to not lose the client id/secret.\n2. Exchange your secret for a JWT using the [OAuth2 Token](ref:gettoken) endpoint.\n3. Create a Project to be managed by the Organization.\n4. Create a Lock Connection for the Project.\n5. Create Keys for your Users.\n\nAll the API endpoints in the Unloc API require a bearer token to be present in the authorization header, with the format authorization: \"Bearer [JWT]\".\n",
    "contact": {
      "name": "Jan Erik",
      "email": "janerik@unloc.app"
    }
  },
  "servers": [
    {
      "url": "https://api.unloc.app",
      "description": "Production server."
    }
  ],
  "tags": [
    {
      "name": "Project",
      "description": "A Project contains all the data for a specific installation of Unloc."
    }
  ],
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "paths": {
    "/v2/organization/{organizationId}/projects": {
      "get": {
        "summary": "Get all Projects in Organization",
        "description": "Returns all <Glossary>Project</Glossary>s owned by this Organization.\n\n| | |\n| --- | --- |\n| Required Scope | `organization.admin` |\n",
        "operationId": "getAllProjectsInOrganization",
        "security": [
          {
            "BearerAuth": [
              "organization.admin"
            ]
          }
        ],
        "tags": [
          "Project"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "organizationId",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid v4"
            },
            "example": "7a5e7123-4a08-4687-b431-d1b737b519ec",
            "description": "ID of the Organzation. Must match the one in the JWT."
          }
        ],
        "responses": {
          "200": {
            "description": "Returns all Projects owned by this <Glossary>Organization</Glossary>.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "projects": {
                      "type": "array",
                      "items": {
                        "description": "A Project is an entity used to logically contain your work. A Project contains Locks, Managed Users, Keys and more.\n\nA Project can be big or small – the size of the Project is up to you. You can have one Project for your entire company, or one Project for each building you manage. But remember that you can't do work across your projects.\n",
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid v4",
                            "example": "dbeb931b-7b6f-4ba1-aea8-69a14e004d78",
                            "description": "The ID of this Project."
                          },
                          "organizationId": {
                            "type": "string",
                            "format": "uuid v4",
                            "example": "345031c2-be07-4d20-adbe-4e51e6ad0fed",
                            "description": "The ID of the Organization that owns this Project. Not to be confused with `Organization Number` which there was a field for in `V1` of the API. See also `externalId`."
                          },
                          "name": {
                            "type": "string",
                            "example": "Property Company - Oslo Department",
                            "description": "The name of this Project."
                          },
                          "countryIso": {
                            "description": "ISO 3166-1 alpha-2 country code.",
                            "type": "string",
                            "example": "NO"
                          },
                          "state": {
                            "type": "string",
                            "enum": [
                              "scheduled",
                              "active",
                              "churned"
                            ],
                            "example": "active",
                            "description": "Where this Project stands in its life with Unloc.\n"
                          },
                          "projectModules": {
                            "type": "object",
                            "description": "A Project can have different modules enabled. This object describes which modules are enabled for this Project.",
                            "properties": {
                              "doorbell": {
                                "type": "object",
                                "description": "Describes settings for the Doorbell Project Module",
                                "properties": {
                                  "active": {
                                    "type": "boolean",
                                    "description": "`True` if this module is active for this Project.",
                                    "example": true
                                  }
                                }
                              },
                              "subproject": {
                                "type": "object",
                                "description": "Describes settings for this Project Module.",
                                "properties": {
                                  "active": {
                                    "type": "boolean",
                                    "description": "`True` if this module is active for this Project.",
                                    "example": true
                                  }
                                }
                              },
                              "mobileKey": {
                                "type": "object",
                                "description": "Describes settings for this Project Module.",
                                "properties": {
                                  "active": {
                                    "type": "boolean",
                                    "description": "`True` if this module is active for this Project.",
                                    "example": true
                                  }
                                }
                              }
                            }
                          },
                          "externalId": {
                            "type": "string",
                            "example": "919424508",
                            "description": "An External ID for this Project. Used if you need to map this Project to an external system. This field was named `organizationId` in version 1 of the API."
                          },
                          "externalIdSuffix": {
                            "type": "string",
                            "example": "_1",
                            "description": "A suffix to the External ID for this Project. Used to supplement the ExternalId with an additional suffix in order to make it unique."
                          },
                          "defaultPrivacyPolicy": {
                            "type": "string",
                            "description": "The default privacy policy for KeyEvents in this Project. Read more about privacy policies in the [Privacy Policy guide](ref:key-events-and-privacy-policy#privacy-policy).",
                            "enum": [
                              "public",
                              "anonymized",
                              "private"
                            ]
                          }
                        },
                        "required": [
                          "name",
                          "id",
                          "countryIso",
                          "organizationId",
                          "state",
                          "projectModules"
                        ]
                      }
                    }
                  },
                  "required": [
                    "projects"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized request. JWT invalid or expired.",
            "content": {
              "application/json": {
                "schema": {
                  "description": "Unauthorized request. JWT invalid or expired.",
                  "properties": {
                    "error": {
                      "type": "string",
                      "description": "Short identifier for the error.",
                      "example": "JsonWebTokenError"
                    },
                    "errorDescription": {
                      "type": "string",
                      "description": "Verbose description of the error meant for human consumption.",
                      "example": "JWT expired"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```