Get information about an account:

GET /accounts/{accountname}

Returns information about a specified account.

Contents

Request Components

HTTP Request

GET https://thingspace.verizon.com/api/m2m/v1/accounts/{accountname}

Resource and Query Parameters

You must include the account name in the path.

Parameter Name Data Type Description
accountname
required		 string The name of the account for which you want information. An account name is usually numeric, and must include any leading zeros.

Header Parameters

The request header must contain a current ThingSpace authorization bearer token and a valid VZ-M2M session token, and must set the content-type to JSON.

 

Parameter Name Data Type Description
Authorization
required		 string HTTP Authorization bearer token.
VZ-M2M-Token
required		 string A valid session token returned by POST /session/login.
Content-Type
required		 string Must be application/json.

Request Body

None.

Success Responses

Status 200

A successful request returns the following account information:

Parameter Name Data Type Description
accountName string The name of the account.
accountNumber string The billing number of the account.
organizationName string The name of the organization that the account is part of.
isProvisioningAllowed boolean True if devices can be added to the account and activated with a single request. False if devices must be added to the account before they can be activated.
carriers array The names of all carriers for the account.
features array The names of features that are enabled for the account.
ipPools array Array of IP pools that are available to the account.
poolName
 string The name of the IP pool.
poolType
 string The type of IP pool, such as “Static IP” or “Dynamic IP.”
isDefaultPool
 Boolean True if this is the default IP pool for the account.
servicePlans array Array of service plans that are available to the account.
name
 string The service plan name.
code
 string The service plan code, used when adding devices or changing device service plans.
sizeKb
 string The amount of data included in the service plan.
carrierServicePlanCode
 string Internal service plan reference code.
extendedAttributes
 string Any extended attributes for the service plan.

Example Success Response

{
  "accountName":"Chintan_CPNStaticBulk",
  "accountNumber":"1234567890-77777",
  "organizationName":"ChintanCPNBulk",
  "isProvisioningAllowed":true,
  "carriers":[
    "Verizon Wireless"
  ],
  "features":[
    "Static IP",
    "Dynamic IP",
    "Customer PN"
  ],
  "ipPools":[
    {
      "poolName":"ACMESTATIC001",
      "poolType":"Static IP",
      "isDefaultPool":true
    },
    {
      "poolName":"ACMEDYNAMIC001",
      "poolType":"Dynamic IP",
      "isDefaultPool":false
    }
  ],
  "servicePlans":[
    {
      "name":"",
      "code":"92876",
      "sizeKb":,
      "carrierServicePlanCode":"",
      "extendedAttributes":""
    },
    {
      "name":"",
      "code":"92876",
      "sizeKb":,
      "carrierServicePlanCode":"",
      "extendedAttributes":""
    }
  ]
}

Failure Responses

Status 400

All error messages are returned in this format:

{
  "errorCode": "error code string",
  "errorMessage": "error message string"
}

Error codes and messages are listed on the Error Messages page, along with explanations and suggestions for corrective actions.

Try It Out!