DocumentationAPI Reference

Account

The Account API provides read-only access to your account details.

When you sign up with Sell we create a single master account for you where you can control settings such as contact phone, default currency and timezone. For each account, you can create as many users as you want.

JSON format

NameTypeRead-onlyMandatoryDescription
idnumbertruetrueUnique identifier of the account.
namestringfalsefalseFull name of the account
currencystringfalsefalseCurrency of the account as the 3-character currency code in ISO4217 format.
time_formatstringfalsefalseTime format used for the account. Either 12-hour clock 12H or 24-hour clock 24H.
timezonestringfalsefalseTimezone of the account as the offset from Coordinated Universal Time (UTC) in the format UTC(+/-)[hh]:[mm].
phonestringfalsefalseContact phone number of the account.
subdomainstringfalsefalseSubdomain of the account, null for legacy accounts.
created_atstringtruetrueDate and time of the account's creation in UTC (ISO8601 format).
updated_atstringtruetrueDate and time of the last update in UTC (ISO8601 format).

Retrieve account details

GET /v2/accounts/self

Allowed for

  • Everyone

Using curl

curl -v -X GET https://api.getbase.com/v2/accounts/self \-H "Accept: application/json" \-H "Authorization: Bearer $ACCESS_TOKEN"

Example Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8Content-Language: en
{  "data": {    "id": 1,    "name": "Sales Co",    "currency": "USD",    "time_format": "12H",    "timezone": "UTC-05:00",    "phone": "202-555-0141",    "subdomain": "sales-experts",    "created_at": "2014-09-28T16:32:56Z",    "updated_at": "2014-09-28T16:32:56Z"  },  "meta": {    "type": "account"  }}