Get Current Credentials

Returns the credentials of the authenticated connection — auth type, granted scopes, effective permissions, and last-used timestamp.

GET /unified/iam/me

Returns information about the connection currently making the request: how it authenticates, what scopes or permissions it holds, and when it was last used.

Authentication

Requires Authorization: Basic {base64_encoded_api_key} and x-account-id: {account_id}. See authentication.

Response

Returns an IamCredentials object.

Field	Type	Description
name	string	Human-readable name of the credential set
auth_type	enum	How the connection authenticates: oauth, api_key, or service_user
scopes	string[]	OAuth scopes granted to this connection. Empty when auth_type is not oauth.
permissions	IamPermission[]	Effective permissions for this connection — what it can do in the provider
last_accessed_at	string (ISO 8601)	When this connection last made an API call

Example

cURL

curl --request GET \
  --url 'https://api.stackone.com/unified/iam/me' \
  --header 'accept: application/json' \
  --header 'authorization: Basic {base64_encoded_api_key}' \
  --header 'x-account-id: {account_id}'

TypeScript

import { StackOne } from "@stackone/stackone-client-ts";

const client = new StackOne({ apiKey: "v1.eu1.xxxxx" });

const response = await client.iam.getMe({
  xAccountId: "your-account-id",
});

console.log(response.credentials);

Python

from stackone_client import StackOne

client = StackOne(api_key="v1.eu1.xxxxx")

response = client.iam.get_me(
    x_account_id="your-account-id"
)

print(response.credentials)

Example Response

{
  "data": {
    "name": "Acme Corp Production",
    "auth_type": "oauth",
    "scopes": [
      "channels:read",
      "users:read"
    ],
    "permissions": [
      {
        "id": "perm_01abc",
        "name": "Read users",
        "type": "read",
        "scopes": [{ "resource_type": "user" }]
      }
    ],
    "last_accessed_at": "2026-03-25T09:12:00.000Z"
  }
}

Errors

Status	Meaning
401	Unauthorized — invalid or missing API key
422	Provider does not support this endpoint