---
title: "List Google Analytics properties for a pending connect"
method: GET
path: "/v1/connect/googleanalytics/properties"
tags: ["Connect"]
---

# List Google Analytics properties for a pending connect

`GET /v1/connect/googleanalytics/properties`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/connect/googleanalytics/properties`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Connect-Token`

For headless flows: lists the GA4 properties of a pending Google Analytics connect, so you can show your own picker.

### Flow

1. The connect started with `redirect_url=...?headless=true`, and the Google account can read several GA4 properties.
2. Zernio redirects to your `redirect_url` with `step=select_property`, `profileId`, `platform=googleanalytics` and a `pendingDataToken`.
3. Call this to list the properties and show your own picker.
4. Call `POST /v1/connect/googleanalytics/select-property`.

### Token

- Listing does not consume the token.
- A headless token passes through your own URLs, so it is honored only together with your API key (or connect token) for the same profile.
- It expires after one hour.

## Query parameters

- `pendingDataToken` string, required

## Response `200`

Properties the Google account can read

- object
  - `properties` object[]
    - `propertyId` string: Numeric GA4 property ID.
    - `displayName` string
    - `accountId` string: Google Analytics account ID.
    - `accountName` string

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `403`: The connect token was issued for a different profile or platform (INSUFFICIENT_PERMISSIONS).
- `404`: The pending sign-in expired or was already used. Start the connect again.

## Changes

- **2026-10-29** `134756fb8dc2`: 1 info
  - added the non-success response with the status `403`
- **2026-10-26** `cef81aa186cc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/connect/googleanalytics/properties/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) - [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/c319eb5d95b6?raw)