---
title: "List OAuth apps"
description: "List your BYOK OAuth app configs per platform."
section: "API reference"
url: https://dravo.dev/docs/api/oauth/list-apps
---
# List OAuth apps

Each app shows the `redirect_uri` you must register on the platform and the
`scopes` Dravo will request. Secrets are never returned.

#### `GET /v1/oauth-apps`

List your BYOK OAuth app configs. Includes the redirect_uri to register, the scopes Dravo will request, and the allowed_return_urls allowlist.

**Auth:** API key (`dra_…`) or dashboard JWT

| Field | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `platform` | query | string | no | Filter by platform. |

Response `200`: OAuth apps.

```json
[
  {
    "id": "oa_1",
    "platform": "x",
    "name": "My X App",
    "client_id": "…",
    "redirect_uri": "https://api.dravo.dev/v1/oauth/x/callback",
    "scopes": [
      "tweet.write",
      "tweet.read",
      "users.read",
      "offline.access",
      "media.write"
    ],
    "allowed_return_urls": [
      "https://app.acme.com/connect"
    ]
  }
]
```