---
title: "Everything the app reads on open, in one request"
method: GET
path: "/api/v1/engage/app-open"
tags: ["Engage"]
---

# Everything the app reads on open, in one request

`GET /api/v1/engage/app-open`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/v1/engage/app-open`
- Auth: HTTP bearer

User, wallets + activeWalletAddress, packs, openedPacks, unread notification count, D-Sports Cash and daily quest summary. Each section is { ok: true, data } or { ok: false, error, code }; one failing section does not fail the others.

## Query parameters

- `walletAddress` string: Scope the pack sections to this wallet; ignored unless the caller owns it.

## Response `200`

{ success, data: AppOpenData }

- AppOpenSuccess
  - `success` true, required
  - `data` AppOpenData, required
    - `user` union, required
      - object
        - `ok` true, required
        - `data` object, required: Same as GET /api/user data for the caller.
      - AppOpenSectionError
        - `ok` false, required
        - `error` string, required
        - `code` string, required
    - `wallets` union, required
      - object
        - `ok` true, required
        - `data` AppOpenWallet[], required
          - `id` string, required
          - `address` string, required
          - `createdAt` string, required
          - `pinMigrationRequired` boolean, required
          - `connectionType` 'CUSTODIAL' | 'EXTERNAL', required
          - `connectionProvider` string, nullable, required
          - `attestationMethod` string, nullable, required
          - `attestedAt` string, nullable, required
          - `attestationKid` string, nullable, required
          - `legalTermsVersion` string, nullable, required
          - `verified` boolean, required
          - `sortOrder` integer, required
          - `label` string, nullable, required
          - `color` string, nullable, required
          - `icon` string, nullable, required
          - `isHidden` boolean, required
      - AppOpenSectionError
        - `ok` false, required
        - `error` string, required
        - `code` string, required
    - `activeWalletAddress` string, nullable, required: Wallet the pack sections are scoped to: ?walletAddress= when the caller owns it, else the first non-hidden wallet, else the first wallet. Null with no wallets or when wallets failed.
    - `packs` union, required
      - object
        - `ok` true, required
        - `data` object, required
          - `packs` object[], required
      - AppOpenSectionError
        - `ok` false, required
        - `error` string, required
        - `code` string, required
    - `openedPacks` union, required
      - object
        - `ok` true, required
        - `data` object, required
          - `packs` object[], required
      - AppOpenSectionError
        - `ok` false, required
        - `error` string, required
        - `code` string, required
    - `notifications` union, required
      - object
        - `ok` true, required
        - `data` object, required
          - `unreadCount` integer, required
      - AppOpenSectionError
        - `ok` false, required
        - `error` string, required
        - `code` string, required
    - `dsportsCash` union, required
      - object
        - `ok` true, required
        - `data` object, required
          - `dsportsCash` integer, required
      - AppOpenSectionError
        - `ok` false, required
        - `error` string, required
        - `code` string, required
    - `dailyQuest` union, required
      - object
        - `ok` true, required
        - `data` object, required: Same as GET /api/v1/engage/quests/daily-summary data.
      - AppOpenSectionError
        - `ok` false, required
        - `error` string, required
        - `code` string, required

## Other responses

- `400`: NUL byte in the request
- `401`: Authentication required
- `500`: Failed to load app-open

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/v1/engage/app-open/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
