---
title: "List the OAuth clients connected to the calling org"
method: GET
path: "/oauth_applications"
tags: ["Connected agents"]
---

# List the OAuth clients connected to the calling org

`GET /oauth_applications`

## Request

- Base URL: `https://thesignup.app/api/v1`
- URL: `https://thesignup.app/api/v1/oauth_applications`
- Auth: HTTP bearer

One entry per (client, user) connection, org-wide. Not paginated — a single org's connected-agent list is bounded by how many clients its members have authorized. Requires `audit_log:read`: the same compliance-facing scope as the audit log, since this answers 'who has access to our data'.

## Response `200`

Live connections for this org

- ListConnectedAgentsResponse
  - `data` ConnectedAgent[], required
    - `clientId` string, required
    - `clientName` string, required
    - `clientUri` string, nullable, required
    - `logoUri` string, nullable, required
    - `isFirstParty` boolean, required: True for clients TheSignup operates itself; these skip the consent screen.
    - `connectedByUserId` string, required: The user who granted consent. Not expanded — join against your own records if you need a display name.
    - `scopes` string[], required: Scopes on the newest live token, falling back to the consent record.
    - `connectedAt` string, date-time, required
    - `lastUsedAt` string, date-time, nullable, required: Null when the connection has been granted but never exercised.
    - `last24hCount` integer, required: Requests made by this connection in the trailing 24 hours.
    - `userAgent` string, nullable, required

## Other responses

- `401`: Unauthenticated — credentials missing, malformed, invalid, or revoked
- `403`: Forbidden — credentials valid but lack the required scope
- `429`: Rate limited or daily ceiling exceeded
- `500`: Internal server error

---

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