TOtogaihq
Accounts

Get an account

Changed on

Get account information using customer_id and account_id.

get/accounts/{account_id}

Request

Path parameters

account_idstring required
Example:ACC00001

account_id corresponding to an account

Query parameters

effectiveOnstring date-time
Example:2020-03-30T10:41:10.088499
includeGroupDetailsboolean
Example:true

Response

Response for Create and Get account requests

idstring required

Identifier of the account

togaiAccountIdstring required

Unique identifier of the account

togaiCustomerIdstring required

Unique identifier of the customer

namestring required

Name of the Account

customerIdstring required

Identifier of the customer

invoiceCurrencystring

ISO_4217 code of the currency in which the account must be invoiced Defaults to Base currency.

netTermDaysinteger
primaryEmailstring

Primary email of the customer

status'ACTIVE' | 'DRAFT' | 'ARCHIVED' required

Status of the account

metadataobject

Additional information associated with the account. Example: GSTN, VATN

tagsstring[]

Tag for accounts are stored in lowercase

Example response

{
  "invoiceCurrency": "USD",
  "primaryEmail": "admin@example.com",
  "status": "ACTIVE"
}

Changes

  • 3135bb8c67b3Revision changes
    • info

      added the optional property to the response with the status

  • 6fb940b0dad9Revision changes
    • breaking

      the response property became optional for the status

    • breaking

      the response property's maxLength was increased from 255 to 320 for the response status

    • warning

      added the new DRAFT enum value to the response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status