---
title: "List subscriber auth integrations"
method: GET
path: "/projects/{project_id}/integrations/subscriber_authentication"
tags: ["SubscriberAuthentication"]
---

# List subscriber auth integrations

`GET /projects/{project_id}/integrations/subscriber_authentication`

## Request

- Base URL: `https://api.beyondwords.io/v1`
- URL: `https://api.beyondwords.io/v1/projects/{project_id}/integrations/subscriber_authentication`
- Auth: API key in header `X-Api-Key`

Returns the subscriber auth integrations (e.g. Ghost) configured for a project.

## Response `200`

with a configured ghost integration

- SubscriberAuthenticationModel[]
  - `type` 'ghost' | 'piano': The subscriber auth adapter type.
  - `site_url` string, nullable: Ghost site URL (only present for the ghost type).
  - `aid` string, nullable: Piano application ID (only present for the piano type).
  - `region` 'us' | 'eu' | 'au' | 'ap' | 'sandbox' | 'null', nullable: Piano dashboard region (only present for the piano type). Blank means us.
  - `created` string, date-time: Time at which the object was created (ISO 8601)
  - `updated` string, date-time: Time at which the object was updated (ISO 8601)

## Other responses

- `401`: Invalid authentication token

## Changes

- **2026-11-03** `994b9853e685`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/changes/projects/:project_id/integrations/subscriber_authentication/get.md)

---

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