# smart-me API

> smart-me API on Apizie: 64 endpoints (Creates a Access Token to write on a Card (e.g. NFC), GET /api/Account/login, POST /api/Account/login, Set an action for the specified device., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/iot:smart-me/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `iot:smart-me`
- Category: IoT
- Status: byok
- Source: https://smart-me.com
- Page: https://apizie.tech/api/iot/smart-me
- OpenAPI: https://apizie.tech/api/iot/smart-me/openapi.json

With the smart-me REST API you get Access to all your devices in the smart-me Cloud and you can add your own devices. So its an easy way to add the smart-me Cloud support to your Hardware or Software Product.

## Endpoints

### Creates a Access Token to write on a Card (e.g. NFC)
`POST https://apizie.tech/v1/iot:smart-me/access-token-put` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### GET /api/Account/login
`GET https://apizie.tech/v1/iot:smart-me/account-login` (byok)

### POST /api/Account/login
`POST https://apizie.tech/v1/iot:smart-me/post-api-account-login` (byok)

### Set an action for the specified device.
`POST https://apizie.tech/v1/iot:smart-me/actions-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Gets all available Actions of a Device
`GET https://apizie.tech/v1/iot:smart-me/actions-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the device |

### Gets the additional information (e.g. Firmware Version) about a device.
`GET https://apizie.tech/v1/iot:smart-me/additional-device-information-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the device |

### Gets all Custom Devices
`GET https://apizie.tech/v1/iot:smart-me/custom-device-get` (byok)

### Creates or updates a Custom Device or updates it's values.
`POST https://apizie.tech/v1/iot:smart-me/custom-device-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Gets a Custom Device by it's ID
`GET https://apizie.tech/v1/iot:smart-me/get-api-custom-device-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the device |

### Gets a Device by it's Serial Number. The Serial is the part before the "-".
`GET https://apizie.tech/v1/iot:smart-me/device-by-serial-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| serial | integer | yes | The Serial Number of the device |

### Gets all Devices
`GET https://apizie.tech/v1/iot:smart-me/devices-get` (byok)

### Creates or updates a Device or updates it's values.
`POST https://apizie.tech/v1/iot:smart-me/devices-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Gets a Device by it's ID
`GET https://apizie.tech/v1/iot:smart-me/get-api-devices-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the device |

### Updates the On/Off Switch on a device. For new implementations please use the "actions" command
`POST https://apizie.tech/v1/iot:smart-me/devices-put` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the device |
| switchState | boolean | yes | The new state of the switch |
| switchNumber | integer | no | The number of the switch if there are multiple (1 for L1, 3 for L3) |

### Gets all Devices for an Energy Type
`GET https://apizie.tech/v1/iot:smart-me/devices-by-energy-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| meterEnergyType | string | yes |  |

### Gets all Devices by it's Sub Type (e.g. E-Charging Station)
`GET https://apizie.tech/v1/iot:smart-me/devices-by-sub-type-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| meterSubType | string | yes |  |

### Force a device to send the data every second (if supported). This for about 30s. Don't use this call to…
`GET https://apizie.tech/v1/iot:smart-me/fast-send-device-values-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Gets the Values for a folder or a meter
`GET https://apizie.tech/v1/iot:smart-me/folder-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Gets the folder menu items (each item might contain child items)
`GET https://apizie.tech/v1/iot:smart-me/folder-menu-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | (optional) Filter for the folders and meters: all: load everything assigned: load only folders and meters that are assigend to a folder… |

### Creates and updates the folder menu items
`POST https://apizie.tech/v1/iot:smart-me/folder-menu-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### A method returning HTTP 200 OK when queried. It is used by Kubernetes probes to determine whether the app is…
`GET https://apizie.tech/v1/iot:smart-me/health-get` (byok)

### M-BUS API: Adds data of a M-BUS Meter to the smart-me Cloud. Just send us the M-BUS Telegram (RSP_UD) and we…
`POST https://apizie.tech/v1/iot:smart-me/mbus-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Sets the Name of a Meter or a Folder
`POST https://apizie.tech/v1/iot:smart-me/meter-folder-information-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Beta: Gets the General Information for a Meter or a Folder
`GET https://apizie.tech/v1/iot:smart-me/meter-folder-information-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Gets the Values for a Meter at a given Date. The first Value found before the given Date is returned.
`GET https://apizie.tech/v1/iot:smart-me/meter-values-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| date | string | yes |  |

### Gets all registrations for the Realtime API.
`GET https://apizie.tech/v1/iot:smart-me/register-for-realtime-api-get` (byok)

### Creates a new registration for the realtime API. The Realtime API sends you the data of the registred…
`POST https://apizie.tech/v1/iot:smart-me/register-for-realtime-api-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Deletes a realtime API registration.
`POST https://apizie.tech/v1/iot:smart-me/register-for-realtime-api-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the realtime API registration |

### Sets the configuration of a smart-me device. The device needs to be online.
`POST https://apizie.tech/v1/iot:smart-me/smart-me-device-configuration-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Gets the configuration of a smart-me device.
`GET https://apizie.tech/v1/iot:smart-me/smart-me-device-configuration-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Creates or updates a subuser. To create a new user set no ID (empty)
`POST https://apizie.tech/v1/iot:smart-me/sub-user-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get a sub user. The user must be assigend to the user that makes this call.
`GET https://apizie.tech/v1/iot:smart-me/sub-user-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Delete a subuser
`POST https://apizie.tech/v1/iot:smart-me/sub-user-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Gets the informations for the user.
`GET https://apizie.tech/v1/iot:smart-me/user-get` (byok)

### Triggers user account deletion.
`POST https://apizie.tech/v1/iot:smart-me/user-delete` (byok)

### Gets all (last) values of a device
`GET https://apizie.tech/v1/iot:smart-me/values-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the device |

### Gets all (last) values of a device The first Value found before the given Date is returned.
`GET https://apizie.tech/v1/iot:smart-me/values-in-past-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the device |
| date | string | yes | the date of the value |

### Gets multiple values of a device. This call needs a smart-me professional licence.
`GET https://apizie.tech/v1/iot:smart-me/values-in-past-multiple-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the device |
| startDate | string | yes | The date when the first value should start |
| endDate | string | yes | The date when the last value should start |
| interval | integer | yes | The interval in minutes betwenn the values. 0 means as fast as possible. Only 1000 values can be get in one call. |

### Beta: Gets all active virtual meters
`GET https://apizie.tech/v1/iot:smart-me/virtual-billing-meter-active-get` (byok)

### Beta: Virtual Meter API: Activates a Meter and add the Consumption to a Virtual Meter assosiated with the…
`POST https://apizie.tech/v1/iot:smart-me/virtual-billing-meter-active-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Beta: Virtual Meter API: Deactivates a Virtual Meter.
`POST https://apizie.tech/v1/iot:smart-me/virtual-billing-meter-deactivate-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Beta: Gets all Meters available to activate as a Virtual Meter.
`GET https://apizie.tech/v1/iot:smart-me/virtual-billing-meters-get` (byok)

### Calculates a virtual meter from a formula. A meter is coded as ID("METERID")
`GET https://apizie.tech/v1/iot:smart-me/virtual-meter-calculate-formula-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| formula | string | yes |  |

### Gets all Virtual Tariffs of a user
`GET https://apizie.tech/v1/iot:smart-me/virtual-tariff-get` (byok)

### Gets all virtual tariffs of a folder
`GET https://apizie.tech/v1/iot:smart-me/get-api-virtual-tariff-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the Folder |

### Gets the consumption of a folder with a virtuall tariffs.
`GET https://apizie.tech/v1/iot:smart-me/virtual-tariff-consumption-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folderId | string | yes | The ID of the Folder |
| startDate | string | yes | The start date (UTC) |
| endDate | string | yes | The end date (UTC) |

### Gets all Virtual Tariffs for a property (folder)
`GET https://apizie.tech/v1/iot:smart-me/virtual-tariffs-for-property-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Gets the calculation status for a virtual tariff property
`GET https://apizie.tech/v1/iot:smart-me/virtual-tariffs-status-for-property-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Assign a folder (source) or meter to another folder (target). Can be used to create a folder structure.
`POST https://apizie.tech/v1/iot:smart-me/folder-assign-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| source | string | yes | The ID of the meter or folder that should be assign |
| target | string | yes | The ID of the meter or folder that should be the parent |

### Gets the settings of a folder or meter
`GET https://apizie.tech/v1/iot:smart-me/folder-settings-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Add or edit a folder or a meter. To add a new folder use and empty ID
`POST https://apizie.tech/v1/iot:smart-me/folder-settings-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the folder or meter to edit. Use and empty ID to add a new folder |
| body | object | yes | JSON request body |

### Deletes a folder
`POST https://apizie.tech/v1/iot:smart-me/folder-settings-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the folder |

### Assign a user to a folder
`POST https://apizie.tech/v1/iot:smart-me/user-to-folder-assign-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| source | string | yes | The ID of the user that should be assign |
| target | string | yes | The ID of the folder that should be the parent |
| oldFolder | string | yes | The ID of the old folder (in case of a drag and drop to a new folder) |

### Deletes a user to folder assignement
`POST https://apizie.tech/v1/iot:smart-me/user-to-folder-assign-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| source | string | yes | The ID of the user that should be de-assign |
| target | string | yes | The ID of the folder |

### GET /api/oauth/authorize
`GET https://apizie.tech/v1/iot:smart-me/oauth-authorize` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string | yes |  |
| redirect_uri | string | yes |  |
| state | string | yes |  |
| scope | string | no |  |
| client_secret | string | no |  |

### POST /api/oauth/authorize
`POST https://apizie.tech/v1/iot:smart-me/post-api-oauth-authorize` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string | yes |  |
| redirect_uri | string | yes |  |
| state | string | yes |  |
| scope | string | no |  |
| client_secret | string | no |  |

### Gets all pico charging stations for this user
`GET https://apizie.tech/v1/iot:smart-me/pico-get` (byok)

### Gets the active charging data of a pico station
`GET https://apizie.tech/v1/iot:smart-me/pico-charging-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Gets the last charging history for a pico station
`GET https://apizie.tech/v1/iot:smart-me/pico-charging-history-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### GET: api/pico/loadmanagementgroup Returns all available load management groups
`GET https://apizie.tech/v1/iot:smart-me/get-api-pico-loadmanagementgroup` (byok)

### Sets the dynamic current of a load management group or a single station.
`POST https://apizie.tech/v1/iot:smart-me/pico-loadmanagement-set-dynamic-current-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| serial | integer | yes | The serial number can be any pico serial in the group (e.g. 700001) |
| current | integer | yes | The dynamic current of the group (in mA) |

### GET: api/pico/loadmanagementgroup Returns a pico load management group by it's id
`GET https://apizie.tech/v1/iot:smart-me/pico-loadmanagement-group-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### GET: api/pico/settings Returns the settings of a pico charging station.
`GET https://apizie.tech/v1/iot:smart-me/pico-settings-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Try to fix lock the cable of a pico. The pico must be online and a cable (without car) needs to be…
`POST https://apizie.tech/v1/iot:smart-me/pico-enable-fix-cable-lock-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the pico |

## Example
```
curl "https://apizie.tech/v1/iot:smart-me/access-token-put" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the smart-me API?
Create a free Apizie key, then send POST https://apizie.tech/v1/iot:smart-me/access-token-put with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the smart-me API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. smart-me itself also needs your own key from smart-me.com.

### Can AI agents use the smart-me API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key iot:smart-me.

### What is the status of the smart-me API?
Needs your own provider key (bring your own key)