> For the complete documentation index, see [llms.txt](https://betmatic.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://betmatic.gitbook.io/documentation/api/for-punters/bookie-account/get-specific-bookie-accounts.md).

# Get specific betting account

## GET /bookieaccount/{id}/

**Operation ID**: `bookieaccount_read`

Retrieve detailed information for a specific bookie account by its ID.

### Path Parameters

| Parameter | Type    | Required | Description                                            |
| --------- | ------- | -------- | ------------------------------------------------------ |
| `id`      | integer | Yes      | A unique integer value identifying this bookie account |

### Response

#### Success Response (200)

Returns a `BookieAccount` object:

```json
{
  "bookie": "TAB",
  "display_name": "TAB Main Account",
  "balance": 1250.50,
  "bonus_balance": 25.00,
  "update_time": "2024-01-24T20:30:00+11:00",
  "bot_ip": "192.168.1.100",
  "bot_id": "BOT001",
  "bot_running": true,
  "login_status": "LOGGED_IN",
  "last_login_attempt": "2024-01-24T20:25:00+11:00",
  "login_error": null,
  "session_details": {
    "active_sessions": 2,
    "session_start_time": "2024-01-24T20:00:00+11:00",
    "last_activity": "2024-01-24T20:29:00+11:00",
    "session_timeout": 3600
  },
  "account_settings": {
    "auto_login": true,
    "login_frequency": 60,
    "max_bet_amount": 500.00,
    "min_bet_amount": 5.00,
    "use_bonus_first": false
  },
  "performance_stats": {
    "total_bets_today": 15,
    "successful_bets_today": 12,
    "failed_bets_today": 3,
    "total_stake_today": 150.00,
    "profit_today": 25.50
  }
}
```

### Response Fields

| Field                | Type     | Description                                 |
| -------------------- | -------- | ------------------------------------------- |
| `bookie`             | string   | Name of the bookmaker                       |
| `display_name`       | string   | User-friendly name for the account          |
| `balance`            | number   | Current account balance                     |
| `bonus_balance`      | number   | Current bonus balance available             |
| `update_time`        | datetime | Last time account information was updated   |
| `bot_ip`             | string   | IP address of the bot managing this account |
| `bot_id`             | string   | Identifier of the bot managing this account |
| `bot_running`        | boolean  | Whether the bot is currently running        |
| `login_status`       | string   | Current login status                        |
| `last_login_attempt` | datetime | Timestamp of last login attempt             |
| `login_error`        | string   | Last login error message (null if no error) |
| `session_details`    | object   | Detailed session information                |
| `account_settings`   | object   | Account configuration settings              |
| `performance_stats`  | object   | Daily performance statistics                |

#### Error Responses

* **401 Invalid credentials** - Authentication token is invalid or missing
* **404 Not Found** - Bookie account with specified ID not found
* **500 Internal server error** - Server encountered an error processing the request

### Usage

```bash
curl -X GET "https://betmatic.app/api/bookieaccount/123/" \
  -H "Authorization: Token your_token"
```

### Potential Use Cases

1. **Detailed Account Analysis**: Get comprehensive information about a specific account's performance
2. **Troubleshooting**: Diagnose issues with specific accounts including login problems
3. **Performance Monitoring**: Track detailed performance metrics for individual accounts
4. **Session Management**: Monitor session status and activity for specific accounts
5. **Account Optimization**: Analyze account settings and performance to optimize configuration
6. **Bot Monitoring**: Check detailed bot status and performance for specific accounts
7. **Balance Verification**: Verify current balance and bonus information for specific accounts
8. **Audit Trail**: Maintain detailed records of account activity and status

### Authentication

This endpoint requires authentication. Include your token in the Authorization header:

```
Authorization: Token your_token_here
```

### Notes

* This endpoint provides more detailed information than the account list endpoint
* Performance statistics are typically calculated for the current day
* Session details help monitor the health of automated betting operations
* Use this endpoint when you need comprehensive information about a specific account