> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hopae.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Apps

> List apps in the workspace with offset pagination.

Lists the workspace's apps, newest first, using offset pagination. The host you call decides which apps are listed: `sandbox.api.hopae.com` lists your sandbox apps, `api.hopae.com` your production apps.

## Request

**Authorization** `string` *required*

`Bearer <API_KEY>` from Console > Developers > Workspace API Keys.

### Query parameters

**limit** `number` (default: 20)

Page size.

**offset** `number` (default: 0)

Number of apps to skip.

## Response

**data** `object[]`

The apps on this page. Each item is the App object [Get App](https://docs.hopae.com/api-reference/workspace/get-app.md) returns.

**total** `number`

Total number of apps listed, across all pages.

**limit** `number`

Page size applied.

**offset** `number`

Offset applied.

```bash theme={null}
curl -H "Authorization: Bearer sk_workspace_test_..." \
  "https://sandbox.api.hopae.com/connect/v1/apps?limit=20&offset=0"
```

```json theme={null}
{
  "data": [
    {
      "clientId": "HqTRDIYH",
      "clientSecret": "sh_app_...",
      "name": "My App",
      "redirectUris": ["https://app.example.com/callback"],
      "providers": {
        "passport": { "config": {} },
        "smartid": { "config": {} }
      },
      "defaultWorkflowId": "wf_6ec9b183",
      "workflows": [
        {
          "workflowId": "wf_6ec9b183",
          "name": "Default",
          "entryNodeId": "nd_231bba48",
          "nodes": [
            { "id": "nd_231bba48", "type": "request", "next": "nd_8fa2291e" },
            { "id": "nd_8fa2291e", "type": "verification", "next": "nd_9ea348df", "config": { "channel": "oidc", "claims": ["name", "given_name", "family_name", "birthdate"], "mode": "pii" } },
            { "id": "nd_9ea348df", "type": "response" }
          ],
          "createdAt": "2026-03-27T08:22:51.272Z",
          "updatedAt": "2026-03-27T08:22:51.272Z"
        }
      ],
      "organizationId": "org_...",
      "webhookConfig": {
        "enabled": false,
        "retryAttempts": 3,
        "timeoutSeconds": 10,
        "events": []
      }
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.