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

# Delete Account

> Permanently delete your account and all associated data (DPDPA compliance)

Permanently delete your account and all associated personal data. This action is **irreversible**.

This endpoint implements the **Right to Erasure** under the Digital Personal Data Protection Act (DPDPA), 2023.

<Warning>
  This action cannot be undone. All your data — screeners, watchlists, credits, AI conversations — will be permanently deleted. Financial records (orders, subscriptions) will be anonymized for audit compliance.
</Warning>

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer <access_token>`
</ParamField>

## What Gets Deleted

| Data                        | Action                                 |
| --------------------------- | -------------------------------------- |
| User profile & credentials  | **Deleted**                            |
| Watchlists                  | **Deleted**                            |
| Saved screeners             | **Deleted**                            |
| Credit ledger               | **Deleted**                            |
| API usage records           | **Deleted**                            |
| AI conversations & messages | **Deleted**                            |
| Rate limit records          | **Deleted**                            |
| Active sessions             | **Invalidated**                        |
| Orders & subscriptions      | **Anonymized** (audit trail preserved) |

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.finscreener.in/api/users/me/account \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```python Python theme={null}
  import requests

  response = requests.delete(
      "https://api.finscreener.in/api/users/me/account",
      headers={"Authorization": f"Bearer {token}"}
  )
  print(response.json()["message"])
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.finscreener.in/api/users/me/account',
    {
      method: 'DELETE',
      headers: { Authorization: `Bearer ${token}` }
    }
  );
  const result = await response.json();
  console.log(result.message);
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "success": true,
    "message": "Your account and associated data have been permanently deleted.",
    "request_id": "req_abc123"
  }
  ```

  ```json Error theme={null}
  {
    "detail": "Account deletion failed. Please contact support at info@finscreener.in"
  }
  ```
</ResponseExample>

## Error Codes

| Status | Description                             |
| ------ | --------------------------------------- |
| 200    | Account deleted successfully            |
| 401    | Unauthorized — invalid or expired token |
| 403    | Account is suspended — contact support  |
| 500    | Deletion failed — contact support       |

<Note>
  After deletion, your access token will no longer work. You will need to create a new account to use Finscreener again.
</Note>
