> This page is for Developers.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.emnify.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.emnify.com/_mcp/server.

> Tariff profile API reference for assigning tariffs to endpoints with rates for data, SMS, and SIM lifecycle operations.

The API provides services to retrieve the collection of tariff profiles or a single tariff profile, as well as CRUD operations via `POST`, `GET`, `PATCH` and `DELETE` actions.

> **Warning**
>
> The API doesn't provide feedback if you assign the wrong tariff profile to a satellite SIM.
>
> **For satellite customers**:
> Only assign endpoints with satellite SIMs to dedicated tariff profiles designed for satellite-converged IoT connectivity services (for example, a satellite data plan or a satellite and cellular combo data plan).
> For troubleshooting, refer to [**Connected Devices**](https://portal.emnify.com/connected-devices) in the emnify Portal.

The following is an example tariff profile in JSON representation:

```json maxLines=15
{
  "id": 1,
  "name": "Tariff Profile 1",
  "description": "This Tariff Profile is for testing.",
  "used_count": 56,
  "tariff": {
    "id": 1,
    "name": "Tariff 1",
    "description": "Tariff only for testing.",
    "created": "2014-10-20 00:00:00",
    "default_sms_mt_rate": 0.06,
    "default_sms_mo_rate": 0.06,
    "sim_issued_rate": 0,
    "sim_activated_rate": 1,
    "sim_suspended_rate": 0,
    "sim_activation_rate": 0,
    "sim_reactivation_rate": 0.5,
    "sim_suspension_rate": 0.5,
    "sim_termination_rate": 0,
    "currency": {
      "id": 1,
      "code": "EUR",
      "symbol": "€"
    },
    "data_blocksize": {
      "id": 1,
      "description": "exact",
      "octets": 1
    },
    "data_throttle": {
      "id": 1,
      "description": "256 kbit/s",
      "octets": 256000
    },
    "pdp_context_definition": [
      {
        "id": 12,
        "apn": "internet.test.com",
        "default": true
      }
    ]
  }
}
```

## Tariff profile object

Here is the description of the tariff profile object:

| Name          | Type    | Description                                                 |
| :------------ | :------ | :---------------------------------------------------------- |
| `id`          | Integer | Unique ID of this tariff profile                            |
| `name`        | String  | short name of this tariff profile                           |
| `description` | String  | long description of this tariff profile                     |
| `used_count`  | Integer | number of Endpoints which have this tariff profile assigned |
| `tariff`      | Object  | tariff which this profile belongs to                        |