> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 계정 정보

> 현재 자격 계정과 누적 데이터 지출.

**`GET`** `https://api-datahub.octoparse.com/v1/account`

인증: API 키 필요(`Authorization: Bearer <API Key>`).

현재 자격 증명 뒤 계정의 식별 정보와 누적 데이터 지출. 시간 차원 없음. 기간·차원별은 <a href="/docs/ko/datahub/api/reference/account/get-billing">청구 집계</a>.

`total_spent`는 데이터 요금만 — App 요금표 기준 실행 출력 청구액. 지갑 잔액·충전·인보이스는 Data Hub API 밖. Octoparse 계정 센터에서 확인. 같은 계정 API 키는 동일 누계.

## 요청

### 요청 예시

```bash theme={null}
curl   -H "Authorization: Bearer $OCTOPARSE_API_KEY"   "https://api-datahub.octoparse.com/v1/account"
```

## 응답

### 200 성공

```json theme={null}
{
  "data": {
    "user_id": "user-carol",
    "username": "carol",
    "total_spent": 0.06,
    "currency": "USD"
  }
}
```

페이로드는 `data`로 감쌉니다. 필드:

<ResponseField name="user_id" type="string" required>
  안정 계정 id.
</ResponseField>

<ResponseField name="username" type="string">
  현재 사용자 이름. 게시 App 첫 세그먼트 `<username>/<app_name>`. 미설정 `null`.
</ResponseField>

<ResponseField name="total_spent" type="number" required>
  누적 데이터 지출.
</ResponseField>

<ResponseField name="currency" type="string">
  통화.
</ResponseField>

### 오류

| HTTP | `code`         | `category`  | 설명              |
| ---- | -------------- | ----------- | --------------- |
| 401  | `unauthorized` | `forbidden` | API 키 누락 또는 무효. |

오류 응답은 `{"error": {code, category, message, retryable}}`입니다. <a href="/docs/ko/datahub/api/reference/introduction#errors">오류</a> 참고.

## 클라이언트 라이브러리

<CodeGroup>
  ```python Python theme={null}
  info = client.account()
  print(info["username"], info["total_spent"], info["currency"])
  ```

  ```js JavaScript theme={null}
  const info = await client.account();
  console.log(info.username, info.total_spent, info.currency);
  ```
</CodeGroup>
