Browse and Modify Account Information

You can browse and modify your account information via the TextMagic SMS API. This page will explain how to do that.

Get current account information

To get account information, use:

GET /api/v2/user

Note, this command has no parameters.

You will receive a response in the following format:

Parameter
Example
Description
id305User ID.
usernamecharles.conwayUsername.
emailcharles@example.comUser email address.
status

A

T

Current account status:

  • A for Active
  • T for Trial.
balance208.64Account balance (in account currency).
currencycurrencySee currency codes below.
firstNameCharlesAccount first name.
lastNameConwayAccount last name.
companyExample Ltd.Account company name.
subaccountTypeA

Type of account:

  • P for Parent User
  • A for Administrator Sub-Account
  • U for Regular User
timezonetimezoneSee timezone codes below.

Currency resource format

The currency records show the account currency and contain the following fields:

Parameter
Example
Description
id

GBP

USD

Three-letter ISO currency ID.
htmlSymbol £
$
HTML-compatible currency symbol.

Timezone resource format

The timezone resource represents the account timezone:

Parameter
Example
Description
id

185

Internal timezone ID.
area

Asia

Europe

Timezone area.
dst1Is Daylight saving time used in this timezone?
offset21600Offset from UTC time in seconds. In this example it is 21600/60/60=6 hours.
timezoneEurope/LondonUser-friendly timezone name (with spaces replaced by underscores).

Edit current account info

To modify account information use PUT:

PUT /api/v2/user

with the following parameters:

Name
Required?
Example
Description
firstNameYes

Charles

Account first name.

lastNameYesConwayAccount last name.
companyYesExample Ltd.Account company name.

If errors are made during the request, the standard error response will be returned.

The next step

Now you’ve learned how to view and edit account information via the TextMagic API, to learn how to manage Sub-accounts, please continue to the next section.