---
title: "Get User Profile"
description: "Retrieves a Reddit user's public profile, karma breakdown, creation timestamp, and account flags.\n"
---

> Documentation Index
> Fetch the complete documentation index at: https://staging.threadapi.dev/llms.txt
> Use this file to discover all available pages before exploring further.

Path: ThreadAPI API › Reddit

`GET /v1/reddit/user`

Retrieves a Reddit user's public profile, karma breakdown, creation timestamp, and account flags.

## Authentication

Requires one of the following:

- `bearerAuth`, http, header `Authorization`
- `apiKeyAuth`, apiKey, in header, header `x-api-key`

## Query parameters

- `name` (`getUser.query.name`; string, required) — Reddit username (e.g. `spez`, with or without `u/`).

## Code samples

### cURL

```bash
curl --request GET \
  --url 'https://api.threadapi.dev/v1/reddit/user?name=spez' \
  --header 'Authorization: Bearer <token>'
```

### TypeScript

```typescript
const url = 'https://api.threadapi.dev/v1/reddit/user?name=spez';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.threadapi.dev/v1/reddit/user?name=spez"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

## Responses

### 200

User profile.

#### Example

```json
{
  "name": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "link_karma": 0,
  "comment_karma": 0,
  "total_karma": 0,
  "is_employee": true,
  "is_mod": true,
  "has_verified_email": true,
  "icon": "string",
  "suspended": true
}
```

- `name` (`getUser.response.200.name`; string, optional)
- `created_at` (`getUser.response.200.created_at`; string, optional)
  - format `date-time`
- `link_karma` (`getUser.response.200.link_karma`; integer, optional)
- `comment_karma` (`getUser.response.200.comment_karma`; integer, optional)
- `total_karma` (`getUser.response.200.total_karma`; integer, optional)
- `is_employee` (`getUser.response.200.is_employee`; boolean, optional)
- `is_mod` (`getUser.response.200.is_mod`; boolean, optional)
- `has_verified_email` (`getUser.response.200.has_verified_email`; boolean, optional)
- `icon` (`getUser.response.200.icon`; string, optional)
- `suspended` (`getUser.response.200.suspended`; boolean, optional)

### 400

Bad request (invalid parameter or unknown action)

#### Example

```json
{
  "error": "unauthorized: missing or invalid credentials",
  "error_code": "insufficient_credits"
}
```

One of:

- `ErrorResponse`
- `Error`

### 401

Missing or invalid API key or OAuth access token

#### Example

```json
{
  "error": "unauthorized: missing or invalid credentials",
  "error_code": "insufficient_credits"
}
```

One of:

- `ErrorResponse`
- `Error`

### 402

The account has no credits left (`insufficient_credits`).

#### Example

```json
{
  "error": {
    "code": "not_found",
    "message": "string",
    "retryable": true,
    "retry_after": 0
  }
}
```

- `error` (`getUser.response.402.error`; object, required)
  - `code` (`getUser.response.402.error.code`; string, required)
    - example `"not_found"`
  - `message` (`getUser.response.402.error.message`; string, required)
  - `retryable` (`getUser.response.402.error.retryable`; boolean, required)
  - `retry_after` (`getUser.response.402.error.retry_after`; integer, optional) — Seconds to wait before retrying.

### 404

Requested user or resource not found

#### Example

```json
{
  "error": "unauthorized: missing or invalid credentials",
  "error_code": "insufficient_credits"
}
```

One of:

- `ErrorResponse`
- `Error`

### 429

Rate limit or daily request quota exceeded

#### Example

```json
{
  "error": "unauthorized: missing or invalid credentials",
  "error_code": "insufficient_credits"
}
```

One of:

- `ErrorResponse`
- `Error`

### 503

A temporary problem reaching Reddit (`upstream_busy`, `upstream_timeout`, `upstream_error`). Retry shortly; nothing was billed.

#### Example

```json
{
  "error": {
    "code": "not_found",
    "message": "string",
    "retryable": true,
    "retry_after": 0
  }
}
```

- `error` (`getUser.response.503.error`; object, required)
  - `code` (`getUser.response.503.error.code`; string, required)
    - example `"not_found"`
  - `message` (`getUser.response.503.error.message`; string, required)
  - `retryable` (`getUser.response.503.error.retryable`; boolean, required)
  - `retry_after` (`getUser.response.503.error.retry_after`; integer, optional) — Seconds to wait before retrying.


Source: https://staging.threadapi.dev/api/Reddit/getUser/index.md