Get profile
GEThttps://api.iot.telenor.com/iot-connect/subscriptions/v1/profiles/:iccid
Fetches a profile with optionally included resources. A profile has a profileType
which can refer to either a SIM_PROFILE
(UICC) or a VIRTUAL_PROFILE
(which resides on an eUICC). A profile always belongs to one IoT subscription and always has one connectivity subscription associated with it. If the profile is a VIRTUAL_PROFILE
it will belong to one eUICC.
Request
Path Parameters
Possible values: Value must match regular expression ^89[0-9]{16,18}$
ICCID to perform request on.
Query Parameters
Possible values: [iotSubscription
, euicc
, connectivitySubscriptions
]
Related resources to include in response. Format as a comma separated list. Omitting this query parameter means that no related resources will be included in response. Note that including resources may result in longer response times so only include what you actually need.
Possible values: [*
, pinPuk
]
Extends the attributes
property in the response body with the specified properties. Format as a comma separated list. Set the value to *
to extend with all available properties. Omitting this query parameter means that no optional properties will be present in attributes
. Note that including extended properties may result in longer response times.
Responses
- 200
- 400
- 401
- 404
- 429
- 500
Contains the requested profile.
- application/json
- Schema
- Example (auto)
Schema
attributes objectrequired
relationships objectrequired
{
"attributes": {
"iccid": "89000000000000000001",
"profileType": "SIM_PROFILE",
"isEnabled": true,
"simProfileId": "9876",
"cmp": "IOTA_EU",
"connectivityProfile": {
"id": "GLOBAL_SUBSCRIPTION",
"name": "Global subscription"
},
"pinPuk": {
"pin1": "1234",
"pin2": "1234",
"puk1": "12345678",
"puk2": "12345678"
}
},
"relationships": {
"iotSubscription": {
"url": "/iot-connect/subscriptions/v1/iot-subscriptions/9746U5LX6B24P3AZ8X"
},
"euicc": {
"url": "/iot-connect/subscriptions/v1/euiccs/89000000000000000000000000000001"
},
"connectivitySubscription": {
"url": "/iot-connect/subscriptions/v1/connectivity-subscriptions/230000000000001"
}
}
}
BadRequest
Response Headers
- application/json
- Schema
- Example (auto)
Schema
errors object[]
{
"name": "string",
"message": "string",
"errors": [
{
"message": "string",
"errorCode": "string",
"path": "string"
}
]
}
Unauthorized. Your token is not valid.
Response Headers
- application/json
- Schema
- Example (auto)
Schema
errors object[]
{
"name": "string",
"message": "string",
"errors": [
{
"message": "string",
"errorCode": "string",
"path": "string"
}
]
}
The specified resource was not found
Response Headers
- application/json
- Schema
- Example (auto)
Schema
errors object[]
{
"name": "string",
"message": "string",
"errors": [
{
"message": "string",
"errorCode": "string",
"path": "string"
}
]
}
RateLimitError. Too Many Requests.
Response Headers
- application/json
- Schema
- Example (auto)
Schema
errors object[]
{
"name": "string",
"message": "string",
"errors": [
{
"message": "string",
"errorCode": "string",
"path": "string"
}
]
}
Internal Server Error
Response Headers
- application/json
- Schema
- Example (auto)
Schema
errors object[]
{
"name": "string",
"message": "string",
"errors": [
{
"message": "string",
"errorCode": "string",
"path": "string"
}
]
}
Authorization: http
name: TokenAuthorizertype: httpscheme: bearerbearerFormat: JWT
- csharp
- curl
- dart
- go
- http
- java
- javascript
- kotlin
- c
- nodejs
- objective-c
- ocaml
- php
- powershell
- python
- r
- ruby
- rust
- shell
- swift
- HTTPCLIENT
- RESTSHARP
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.iot.telenor.com/iot-connect/subscriptions/v1/profiles/:iccid");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());