Get the account

GET/account

account:read EnterpriseOpen GuestSince v2

The account the key belongs to: its plan and subscription, the key itself (its name, environment and the access it really has on this plan) and, on Enterprise, the organisation and its seats. seats.used counts the members who hold a seat; the owner holds none.

Request

curl 'https://api.measuremaponline.com/api/v2/account' \
  -H "Authorization: $MMO_API_KEY"

Response

{
  "type": "account",
  "id": "o7Hs2Kd9Lq4WmZ1x",
  "fullName": "Alex Boss",
  "email": "alex@example.com",
  "company": "Alex Surveys",
  "plan": "enterprise",
  "subscription": {
    "status": "active",
    "active": true,
    "interval": "month",
    "currentPeriodStart": 1791200000000,
    "currentPeriodEnd": 1793800000000,
    "cancelAtPeriodEnd": false,
    "paused": false,
    "currency": "EUR",
    "seats": {
      "total": 5,
      "used": 2,
      "autoAdd": false
    }
  },
  "key": {
    "name": "Back office",
    "environment": "live",
    "scopes": [
      "account:read",
      "projects:read",
      "users:read"
    ]
  },
  "organization": {
    "name": "Alex Surveys"
  }
}

Responses

Account:
- typestringrequired
  Always"account"
- idstringrequired
  The account's ID, the uid for your own account in the endpoints that take one.
- fullNamestring
- emailstring(email)
- companystring
- planstringrequired
  One ofenterpriseopen_guest
- subscriptionobjectrequired
- keyobjectrequired
  The key that made the request.
- organizationobject
  Enterprise only.

Errors

A failed request answers with one of these, in an Error body.

403insufficient_scopeThe key does not have the access this endpoint needs. Create a key with that access.

403invalid_api_keyNo key was sent in the Authorization header, or the key is unknown, revoked, or past the time it kept working after being replaced.

403invalid_subscriptionYour plan has no API access. The API is part of the Enterprise and Open Guest plans.

403subscription_expiredYour subscription is not active. Update your payment method in the app.

Try it

API key

This key is

The key stays in this tab and goes only to the API. Use a sandbox key while you try things: requests are real, and what they change is changed.

GET https://api.measuremaponline.com/api/v2/account

Fill in your API key to send.

As a cURL command

Shell

curl 'https://api.measuremaponline.com/api/v2/account' \
  -H "Authorization: $MMO_API_KEY"