Settings
My Account
Everything about your own subscription: what you pay, when you pay it, and what you have paid so far.
Last updated 2026-10-13
DigitalKey ERP — Docs · digital-key.co/docs/settings/my-account
Overview
Balance and subscriptions are held per user, not per business. This screen is about you specifically — a colleague's balance and features are their own.
My Account — My Account screen

NoteMy Account is also where the business's settings live — team and permissions, invoice and PO print settings, currency, workflow, the activity log and the recycle bin each have a tab here. See Settings Overview. This page covers the first tab.
Billing information
GET /api/v1/billing/my-info
| Parameter | Type | Required | Description |
|---|---|---|---|
username | string | Optional | Your sign-in name. |
full_name | string | Optional | Your display name. |
lifecycle_status | string | Optional | Your account state — registered, active, temp_suspend, suspend or deactivated. |
balance | decimal | Optional | What is left in your account, in IQD. |
billing_day | integer | Optional | Day of the month you are billed on, fixed at first login. |
last_billed_at | date | Optional | When you were last billed. |
next_billing_at | date | Optional | When the next deduction is due. |
first_login_at | timestamp | Optional | When you first signed in. |
status_changed_at | timestamp | Optional | When your lifecycle state last changed. Grace periods count from here. |
monthly_total | decimal | Optional | Total monthly cost of everything you subscribe to. |
features[] | array | Optional | Each subscribed feature with its own monthly price. |
ImportantThe number that matters is
balance against monthly_total. If the balance will not cover the monthly total by next_billing_at, the deduction fails and a grace period starts. Check this before the date, not after. All of these figures are in Iraqi Dinar, whatever your business's main currency is.Your subscribed features
Each feature you are subscribed to is listed with its monthly price. Together they make up monthly_total.
NoteFree features —
pos.quick_sale is the only one — appear in the list but add nothing to the total. A user with only free features is still billed on schedule; the deduction is simply zero, and the billing dates still advance.Deduction history
GET /api/v1/billing/my-deductions
| Parameter | Type | Required | Description |
|---|---|---|---|
deduction_id | integer | Optional | Identifier. |
feature_name | string | Optional | Which feature was charged for. |
feature_key | string | Optional | The feature key. |
amount | decimal | Optional | Amount deducted, in IQD. |
period_month | date | Optional | The month being paid for. |
status | string | Optional | success, failed_low_balance or free. |
deducted_at | timestamp | Optional | When the deduction ran. |
WarningA row with status
failed_low_balance is a missed payment. It marks the start of a grace period — see Lifecycle States for what happens next and how long you have.Top-up history
GET /api/v1/billing/my-topups
| Parameter | Type | Required | Description |
|---|---|---|---|
topup_id | integer | Optional | Identifier. |
amount | decimal | Optional | Amount added, in IQD. |
topped_up_by_role | string | Optional | Whether an admin or a reseller added it. |
payment_method | string | Optional | How it was paid, when recorded. |
notes | string | Optional | Any note left with the top-up. |
created_at | timestamp | Optional | When it was credited. |
NoteYou cannot top up your own balance from inside the ERP. Balance is added by a platform administrator or by your reseller — contact whoever set your account up.
Profile
Your name, email, phone and profile photo can be changed here, and your password changed from the same screen.
Profile endpoints
| Parameter | Type | Required | Description |
|---|---|---|---|
GET /auth/profile | endpoint | Optional | Read your profile. |
PUT /auth/profile | endpoint | Optional | Update name, email and phone. |
POST /auth/change-password | endpoint | Optional | Change your password. |
POST /auth/profile/photo | endpoint | Optional | Upload a profile photo. |
Related
- How Billing Works — the monthly cycle.
- Lifecycle States — what happens when balance runs out.
- Feature Store — changing what you subscribe to.