Overview

The API uses Bearer token authentication. API keys are created in the Dashboard and scoped to the company they belong to.

Creating an API key

1. Navigate to Settings > Integrations > API keys in the Dashboard
2. Click Add API Key
3. Give the key a descriptive label (e.g., "Monitoring integration" or "Reporting script")
4. Copy the key immediately—it is only shown once

Using the API key

Include the key in the Authorization header of every request:

curl -X POST https://api.meter.com/api/v1/graphql \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "{
      virtualDevice(UUID: \"...\") {
        UUID
        label
        isOnline
      }
    }"
  }'

Key management

• Last used: the Dashboard shows when each key was last used
• Revocation: revoke a key from the Dashboard to immediately block access
• Multiple keys: create separate keys for different integrations to manage access independently

Scoping

API keys are scoped to the company they are created under. A key can access data for any network belonging to that company but cannot access data from other companies.

Best practices

• Never commit API keys to source control. Use environment variables or a secrets manager.
• Rotate keys periodically. Revoke old keys and create new ones.
• Create separate keys for each integration so you can revoke access independently.

Need help?

If you run into any issues or have questions, please reach out to our Support Engineering team by opening a ticket via the Dashboard: https://dashboard.meter.com/support