List service profiles

GET

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

GET

/api/v1/service_profile

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

1 [
2   {
3     "id": 232,
4     "name": "Smart meter",
5     "description": "Data + SMS - 1G limit",
6     "used_count": "2",
7     "allowed_3g": true,
8     "allowed_4g": false,
9     "allowed_nb_iot": false,
10     "allowed_nb_iot_geo": false,
11     "apply_sms_quota": false,
12     "apply_data_quota": false,
13     "ip_firewall_rule_set": {
14       "ip_firewall_profiles": [
15         {
16           "id": 43,
17           "name": "Default Inbound Block",
18           "added": "2026-04-09T11:12:45+00:00"
19         }
20       ],
21       "enforce": true
22     },
23     "dns_firewall_rule_set": {
24       "dns_firewall_profiles": [
25         {
26           "id": 10,
27           "name": "Corporate DNS Policy",
28           "added": "2026-07-07T08:15:00+00:00"
29         }
30       ],
31       "enforce": true,
32       "mode": "whitelist"
33     }
34   },
35   {
36     "id": 2,
37     "name": "Arduino",
38     "description": "Data - unlimited",
39     "used_count": "7",
40     "allowed_3g": true,
41     "allowed_4g": true,
42     "allowed_nb_iot": true,
43     "apply_sms_quota": false,
44     "apply_data_quota": false
45   }
46 ]

ServiceProfile + List

Roles: Administrator User Observer

Retrieves a collection of all service profiles for your organization.

Returned service profiles contain just the total count of associated services, so this is the short view.

<Info icon="fa-light fa-lock" className="permission-callout"> <div className="permission-callout__header"><span className="permission-callout__title"><span className="permission-callout__label">Required permissions</span> <span className="fern-docs-badge small blue subtle rounded-full permission-callout__beta">Beta</span></span> <span className="permission-callout__learn-more">[Learn more](/developers/api-guidelines/permissions#how-permissions-work)</span></div> `ServiceProfile` + `List` <div className="permission-callout__roles"><span className="permission-callout__roles-label">Roles:</span> <Badge intent="info">Administrator</Badge> <Badge intent="info">User</Badge> <Badge intent="info">Observer</Badge></div> </Info> Retrieves a collection of all service profiles for your organization. Returned service profiles contain just the total count of associated services, so this is the short view.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

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

Response

Success

idintegerOptional

namestringOptional

descriptionstringOptional

used_countstringOptional

allowed_3gbooleanOptional

allowed_4gbooleanOptional

allowed_nb_iotbooleanOptional

allowed_nb_iot_geobooleanOptional

apply_sms_quotabooleanOptional

apply_data_quotabooleanOptional

ip_firewall_rule_setobjectOptional

dns_firewall_rule_setobjectOptional

Errors

403

Forbidden Error