---
title: "Resolve an Extendy install ID to install info"
method: POST
path: "/api/v1/extendy/getInstall"
tags: ["Extendy"]
---

# Resolve an Extendy install ID to install info

`POST /api/v1/extendy/getInstall`

## Request

- Base URL: `https://api.pwapps.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pwapps.com/api/v1/extendy/getInstall`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/pwapps/apis/curie-api/docs/api/v1/extendy/getInstall/post.ts> (a function with typed inputs; its response is checked against the schema)

Extendy calls this with the install ID it received via sub_id_10 on the offer (our external_id plus Extendy's static '::|00028' suffix). We strip the suffix, look up the matching install, and confirm it is ours.

`external_id`/sub_id_10 is our internal `app_events.id` (the click/install row's own UUID) — this system has no separate user record, so the event ID doubles as the user identifier and is set unconditionally at install time, regardless of the install's registration (lead) status.

Enabled only when the `extendy_integration` feature flag is on globally AND the owning account has `extendy_enabled` set (the company, for company-owned trackers, or the tracker's own user, for solo/individual trackers with no company) AND the install's stream (tracker) has `extendy_enabled` set; otherwise resolves as not found. The opt-in is per stream — traffic sources only record which ad source an install came from.

## Request body

- ExtendyGetInstallRequestDTO
  - `id` string, required: Install ID as sent by Extendy, e.g. '<uuid>::|00028'.

## Response `200`

Successful Response

- ExtendyInstallResponseDTO
  - `type` string
  - `installId` string, required
  - `appId` string, nullable
  - `customAppName` string, nullable
  - `locale` string, required
  - `countryCode` string, nullable
  - `timezone` string, required

## Other responses

- `401`: Authentication required.
- `404`: The requested resource was not found.
- `422`: Validation Error

## Changes

- **2026-10-09** `2e36b261303f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pwapps/apis/curie-api/changes/api/v1/extendy/getInstall/post.md)

---

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