# Client identity endpoint

`GET https://merchant.shuttleglobal.com/whoami`

Not part of the OAuth 2.0 spec but commonly used by APIs.
Returns the identity of the client associated with the access token.

This endpoint allows clients to retrieve their own identity information
without having to store their client ID.

## Authentication

- bearerAuth: Access token

## Responses

### 200: Client identity information

```json
{
  "id": "cl_12345",
  "name": "Payment Processing App"
}
```

### 401: Invalid or expired token

```json
{
  "error": "invalid_token",
  "error_description": "The access token provided is expired, revoked, or invalid"
}
```

## Example request

```sh
curl --request GET \
  --url https://merchant.shuttleglobal.com/whoami \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

Reference page: https://docs.shuttleglobal.com/platforms/reference/oauth/operations/getclientidentity/