GET /apps/me/installations

Description

Retrieve list of associated Workspaces (Campaigns/Orgs who have connected to your App). You must provide your system-level JWT to authenticate to this endpoint.

Overview

This endpoint will also return your App's Workspace ID and Installation ID which can be used for testing the API, testing your integration, and accessing your own datasets.

In the response body, you'll receive a list of Workspaces connected to your App. You'll use the Workspace ID to find the installationId needed for the /clientTokenendpoint.

Note: An Organization or Campaign must provide their Workspace ID and Workspace Key to you.

Parameters

None

URL Structure

https://app.movementinfrastructure.org/api/v1/apps/me/installations

Example

{
    "metadata": {
        "count": 2
    },
    "data": [
        {
            "installationId": 423467,
            "movementAppId": "789ex3a5-mpl3-43f0-e198-x45a9m58p1ee",
	          "workspaceId": 3,
            "createdBy": {
                "userId": 14,
                "displayName": "Jane for Senate",
                "email": "[email protected]"
            },
            "dateCreated": "2024-08-21T23:16:34.230069",
            "name": "My Test DXAPI App"
        },
        {
            "installationId": 1235643,
            "movementAppId": "789ex3a5-mpl3-43f0-e198-x45a9m58p1ee",
	          "workspaceId": 3,	
            "createdBy": {
                "userId": 80,
                "displayName": "Soledad for Governor",
                "email": "[email protected]"
            },
            "dateCreated": "2024-08-22T01:18:11.469141",
            "name": "My Test DXAPI App"
        }
    ]
}