List OAuth clients

Overview

List the OAuth clients owned by the caller, ordered by name.

Prerequisites

  • A bearer token in the Authorization header.

Base URL

EnvironmentURL
Productionhttps://production-api.shoutaboutus.com
Developmenthttps://development-api.shoutaboutus.com

Endpoint

GET /api/v1/sso/list/client

Authentication

  • Requires a bearer token in the Authorization: Bearer <bearer-token> header.

  • bearer token. Only the caller's own clients (owner_id = caller) are returned.

Rate limit

  • No rate limit.

How it works

  • 200 with a nested data.data array of clients (id, name, grant_types, redirect_uris, revoked, timestamps). Secrets are never listed here.

Response

200 OK · 200

{
  "data": {
    "status": "success",
    "data": [
      {
        "id": "019eeeca-2288-73a4-ac88-7c3f105bcc22",
        "name": "test 2",
        "grant_types": [
          "authorization_code",
          "refresh_token"
        ],
        "redirect_uris": [
          "https://fb.com"
        ],
        "revoked": false,
        "created_at": "2026-06-22T10:04:45.000000Z",
        "updated_at": "2026-06-22T10:05:43.000000Z"
      }
    ]
  }
}

401 Unauthenticated · 401

{
  "message": "Unauthenticated."
}

Errors

StatusMeaning
401Unauthenticated
500Unexpected server error

Example request

curl --request GET \
  --url "https://production-api.shoutaboutus.com/api/v1/sso/list/client" \
  --header 'Authorization: Bearer <bearer-token>' \
  --header 'Accept: application/json'

Did this page help you?