---
title: "Get all installations for an app"
method: GET
path: "/app/installations"
tags: ["Apps"]
---

# Get all installations for an app

`GET /app/installations`

## Request

- Base URL: `https://api.carbonregistry.com`
- URL: `https://api.carbonregistry.com/app/installations`
- Auth: none declared
- TypeScript: <https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api/docs/app/installations/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint returns all active installation for an app

## Query parameters

- `limit` number, required
- `page` number, required

## Headers

- `x-icr-api-version` string

## Response `200`

- InstallationssResponseDto
  - `pagination` ApiPaginationDto, required
    - `total` number, required: Total number of items
    - `currentPage` number, required: Current page number
    - `pageCount` number, required: Total number of pages
    - `nextPage` number: Next page number
    - `prevPage` number: Previous page number
  - `installations` ApiInstallationDto[], required
    - `id` string, required: The ID of the installation
    - `createdAt` string, date-time, required: The creation date of the installation
    - `updatedAt` string, date-time, required: The update date of the installation
    - `organization` ApiInstallationOrganizationDto, required
      - `createdAt` string, date-time, required: The creation date of the organization
      - `updatedAt` string, date-time, required: The update date of the organization
      - `fullName` string, required: The full name of the organization
      - `countryCode` string, required: The ISO 3166-1 alpha-2 country code of the organization
      - `city` string: The city of the organization
      - `zip` string: The zip code of the organization
      - `physicalAddress` string: The physical address of the organization
      - `registrationNumber` string: The registration number of the organization
      - `website` string: The website of the organization
      - `logo` string, required: The logo of the organization
      - `id` string, required: The ID of the organization
      - `organizationIndustries` ApiOrganizationIndustries
        - `code` string: The code of the organization industries
        - `name` string: The name of the organization industries
      - `type` 'projectProponent' | 'projectDeveloper' | 'vvb' | 'marketplace' | 'broker' | 'exchange' | 'buyer' | 'insurance' | 'consultancy' | 'dataAndAnalytics' | 'monitoringAndReporting' | 'newsAndMedia' | 'investmentAndFinancing' | 'ratingsAgency' | 'ghgProgram' | 'other', required: The type of the organization
      - `isPublic` boolean, required: The public status of the organization
      - `url` string, required: The api URL of the organization
    - `permissions` object, required: The permissions of the installation
    - `appNameId` string, required: The app name ID of the installation
    - `appId` string, required: The app ID of the installation
    - `accessTokensUrl` string, required: The access tokens URL of the installation

---

[API](https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api.md) - [All operations](https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api/revisions/a9f1b102faca?raw)