Retrieve a service profile

GET

https://cdn.emnify.net/api/v1/service_profile/:profile_id

GET

/api/v1/service_profile/:profile_id

curl https://cdn.emnify.net/api/v1/service_profile/1.1 \
     -H "Authorization: Bearer <token>"

{
  "id": 232,
  "name": "Smart meter",
  "description": "Data + SMS - 1G limit",
  "allowed_3g": 1,
  "allowed_4g": 1,
  "allowed_nb_iot": 1,
  "allowed_nb_iot_geo": 0,
  "apply_sms_quota": 0,
  "apply_data_quota": 0,
  "retail": 0,
  "sms_p2p_int": 1,
  "sms_p2p_ext": 1,
  "nipdp": "0",
  "used_count": "12",
  "api_callback": {
    "created": "2019-03-18T16:11:07.000Z",
    "id": 38,
    "purpose": "Customer's Webserver",
    "url": "https://www.customers-server.com"
  },
  "api_secret": {
    "id": 38,
    "purpose": "K3"
  },
  "moc_callback": {
    "created": "2019-03-18T16:11:17.000Z",
    "id": 39,
    "purpose": "Customer's Moc server",
    "url": "https://moc.customers-server.com"
  },
  "esme_interface_type": {
    "description": "Console",
    "id": 3
  },
  "breakout_region": {
    "id": 3,
    "ip_address": "0.0.0.0",
    "name": "eu-west-1"
  },
  "service": [
    {
      "description": "Data",
      "id": 123,
      "teleservice_code": 7678345,
      "traffic_limit": [
        {
          "id": 123,
          "period": {
            "id": 33,
            "time_units": 5,
            "unit": "Days"
          },
          "volume": 64
        },
        {
          "id": 234,
          "period": {
            "id": 35,
            "time_units": 1,
            "unit": "Months"
          },
          "volume": 128
        }
      ],
      "traffic_type": {
        "description": "Data",
        "id": 1,
        "unit": "GB"
      }
    }
  ],
  "ip_firewall_rule_set": {
    "ip_firewall_profiles": [
      {
        "id": 43,
        "name": "Default Inbound Block",
        "added": "2026-04-09T11:12:45+00:00"
      }
    ],
    "enforce": true
  },
  "dns_firewall_rule_set": {
    "dns_firewall_profiles": [
      {
        "id": 10,
        "name": "Corporate DNS Policy",
        "added": "2026-07-07T08:15:00+00:00"
      }
    ],
    "enforce": true,
    "mode": "allowlist"
  },
  "d2d": {
    "mode": "enabled",
    "modified_at": "2026-08-04T09:15:22+00:00"
  }
}

ServiceProfile + Get

Roles: Administrator User Observer

Retrieve a service profile with a given id.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Path parameters

profile_iddoubleRequired

The Numeric ID of a Service Profile

Response

Success

idintegerOptional

namestringOptional

descriptionstringOptional

allowed_3genumOptional