> For the complete documentation index, see [llms.txt](https://docs.bunny.com/developer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bunny.com/developer/api-reference/types/account.md). # Account An account record is used to represent a customer or trialist | Name | Type | Description | | -------------------------- | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | | accountType | [AccountType](/developer/api-reference/types/accounttype.md) | The type of account | | accountTypeId | ID | Type of account | | addressValidated | Boolean | Address validated status | | ancestorAccounts | List ([Account](/developer/api-reference/types/account.md)) | Account hierarchy path from immediate parent up to the root | | annualRevenue | Int | Annual revenue | | arr | Float | ARR (Annual Recurring Revenue) amount | | balances | List ([AccountBalance](/developer/api-reference/types/accountbalance.md)) | | | billingCity | String | City for billing | | billingContact | [Contact](/developer/api-reference/types/contact.md) | Contact for billing correspondence | | billingContactId | ID | Contact for billing correspondence | | billingCountry | String | Country for billing | | billingDay | Int | Day of the month to process billing | | billingState | String | State for billing | | billingStreet | String | Street address for billing | | billingZip | String | Zip/PostalCode for billing | | childAccounts | List ([Account](/developer/api-reference/types/account.md)) | Direct child accounts in the hierarchy | | code | String | Custom unique identifier for the account | | consolidatedBilling | Boolean | Enable consolidated billing for this account | | contacts | List ([Contact](/developer/api-reference/types/contact.md)) | List of contacts for the account | | createdAt | ISO8601DateTime | Datetime the account was created | | currency | [Currency](/developer/api-reference/types/currency.md) | Primary currency for billing | | currencyId | ID | Primary currency for billing | | customFieldDefinitions | List ([CustomField](/developer/api-reference/types/customfield.md)) | Custom field definitions for this object type | | customFieldsData | JSON | All custom field values for this object as a JSON object | | dealDefaults | [Deal](/developer/api-reference/types/deal.md) | Default values for a new deal | | deals | List ([Deal](/developer/api-reference/types/deal.md)) | List of deals for the account | | descendantAccounts | List ([Account](/developer/api-reference/types/account.md)) | All descendant accounts in the hierarchy (full subtree, excludes self) | | description | String | Description of the account | | disableDunning | Boolean | Indicates if dunning is disabled for this account | | draftInvoices | Boolean | Send new invoices to draft state | | duns | String | Dun & Bradstreet Number | | effectiveBillingDate | ISO8601Date | Next effective billing date calculated from billing\_day | | emailsEnabled | Boolean | Enable sending emails to account contacts | | employees | Int | Number of employees | | entity | [Entity](/developer/api-reference/types/entity.md) | The entity this account belongs to | | entityId | ID | The ID of the entity this account belongs to | | entityUseCode | String | Tax entity use code | | fastForwarded | Boolean | Whether the account is currently displaced into the future by a fast forward | | fastForwarding | Boolean | Whether a fast forward simulation is in progress | | fax | String | Primary fax number for the account | | forwardTo | ISO8601Date | Target date of the fast forward simulation (sandbox only) | | forwardedTo | ISO8601Date | Last date the account has been fast forwarded to (sandbox only) | | groupId | ID | Group that the account belongs to | | hasChildAccounts | Boolean | Whether this account has at least one direct child account | | hasCustomFields | Boolean | Whether this object type has any custom fields defined | | id | ID | Unique identifier for the account | | inHierarchy | Boolean | Whether this account participates in a hierarchy (has a parent or any child) | | industry | [Industry](/developer/api-reference/types/industry.md) | The industry the account belongs to | | industryId | ID | Industry the account belongs to | | invoiceTemplate | [InvoiceTemplate](/developer/api-reference/types/invoicetemplate.md) | Invoice template to be used for invoice generation | | invoiceTemplateId | ID | Invoice template to be used for invoice generation | | invoicedAccount | [Account](/developer/api-reference/types/account.md) | Account that receives invoices; resolves to self when no delegation is set | | invoicedAccountId | ID | Account that receives invoices generated by this account (NULL means self) | | invoices | List ([Invoice](/developer/api-reference/types/invoice.md)) | Invoices for the account | | linkedinUrl | String | Link to the account's LinkedIn profile | | mrr | Float | MRR (Monthly Recurring Revenue) amount | | mur | Float | MUR (Monthly Usage Revenue) amount | | name | String | Name of the account | | netPaymentDays | Int | Payment terms in days | | newQuoteBuilder | Boolean | Use the new quote builder to create quotes and invoices | | nextRenewal | ISO8601Date | Next renewal date from active evergreen subscriptions | | owner | [User](/developer/api-reference/types/user.md) | Account owner | | ownerUserId | ID | Account owner | | parentAccount | [Account](/developer/api-reference/types/account.md) | Parent account in the account hierarchy | | parentAccountId | ID | Parent account in the account hierarchy | | payingAccount | [Account](/developer/api-reference/types/account.md) | Account whose payment method is used; resolves through invoiced\_account when not set | | payingAccountId | ID | Account whose payment method pays invoices generated by this account (NULL means same as invoiced) | | payingStatus | [PayingStatus](/developer/api-reference/enums.md#payingstatus) | Paying status | | paymentMethods | [PaymentMethodConnection](/developer/api-reference/types/paymentmethodconnection.md) | Payment methods associated with this account | | phone | String | Primary phone number for the account | | recurringRevenues | List ([RecurringRevenue](/developer/api-reference/types/recurringrevenue.md)) | Recurring revenues for the account | | revenueMovements | List ([RevenueMovement](/developer/api-reference/types/revenuemovement.md)) | | | revenueToDate | Float | Total revenue recognized to date | | rootAncestorAccount | [Account](/developer/api-reference/types/account.md) | The topmost ancestor in the hierarchy (the account with no parent); resolves to self when this account has no parent | | sandbox | Boolean | Whether the account belongs to a sandbox warren (enables fast forward) | | secondaryBillingContactIds | List (ID) | Secondary billing contact IDs | | secondaryBillingContacts | List ([Contact](/developer/api-reference/types/contact.md)) | Secondary billing contact IDs | | shippingCity | String | City for shipping | | shippingCountry | String | Country for shipping | | shippingState | String | State for shipping | | shippingStreet | String | Street address for shipping | | shippingZip | String | Zip/PostalCode for shipping | | subscriptions | List ([Subscription](/developer/api-reference/types/subscription.md)) | List of subscriptions | | taxNumber | String | Tax number | | taxNumberValidated | Boolean | The tax number supplied has been validated with an official source | | timezone | String | Time zone for the account | | transactions | List ([Transaction](/developer/api-reference/types/transaction.md)) | | | upcomingBillingDates | List (ISO8601Date) | Upcoming account billing dates based on the current subscrptions | | updatedAt | ISO8601DateTime | Datetime the account was last updated | | validInvoicedCandidates | List ([Account](/developer/api-reference/types/account.md)) | Accounts that may be assigned as this account's invoiced\_account (self and ancestor chain) | | validParentCandidates | List ([Account](/developer/api-reference/types/account.md)) | Accounts that may be assigned as this account's parent (same warren and entity, excluding self and its descendants) | | validPayingCandidates | List ([Account](/developer/api-reference/types/account.md)) | Accounts that may be assigned as this account's paying\_account given the currently saved invoiced\_account (invoiced + its ancestors) | | website | String | Website of the account | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.bunny.com/developer/api-reference/types/account.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.