# List deleted users

Retrieve a list of soft-deleted user accounts. Admin-only endpoint for user management and audit purposes.

Returns users where `is_deleted=true`. Useful for admin operations, audit trails, and potential account recovery.

**Access Control:** Admin-only endpoint. Requires Owner or Admin role in at least one organization.

#### Query Parameters

**`skip`** integer optional · Defaults to `0`

Number of records to skip for pagination.

**`limit`** integer optional · Defaults to `100`

Maximum number of records to return. Maximum value is 100.

## Returns

Returns a JSON response indicating success or failure.

Request

```bash
curl -X GET "https://api.aitronos.com/v1/user/deleted?skip=0&limit=10" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.get(
    "https://api.aitronos.com/v1/user/deleted",
    headers={"X-API-Key": api_key},
    params={"skip": 0, "limit": 10}
)

deleted_users = response.json()
print(f"Found {len(deleted_users)} deleted users")
```


```javascript
const apiKey = process.env.FREDDY_API_KEY;

const response = await fetch('https://api.aitronos.com/v1/user/deleted?skip=0&limit=10', {
  headers: {
    'X-API-Key': apiKey
  }
});

const deletedUsers = await response.json();
console.log(`Found ${deletedUsers.length} deleted users`);
```

200 OK

```json
[
  {
    "id": "usr_abc123",
    "email": "deleted.user@example.com",
    "username": "deleted_user",
    "full_name": "Deleted User",
    "is_active": false,
    "is_deleted": true,
    "created_at": "2025-01-01T10:00:00Z",
    "deleted_at": "2025-01-10T15:30:00Z"
  },
  {
    "id": "usr_def456",
    "email": "another.deleted@example.com",
    "username": "another_deleted",
    "full_name": "Another Deleted",
    "is_active": false,
    "is_deleted": true,
    "created_at": "2024-12-15T08:00:00Z",
    "deleted_at": "2025-01-12T12:00:00Z"
  }
]
```

403 Forbidden

```json
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "Admin access required to list deleted users.",
    "system_message": "Admin access required to list deleted users.",
    "type": "authorization_error",
    "status": 403,
    "details": {},
    "trace_id": "req_abc123xyz",
    "timestamp": "2025-12-22T15:30:00Z"
  }
}
```

## Related Resources

- [Get Profile](/docs/api-reference/users/get-profile)