SIM

The API provides services to retrieve the collection of SIMs with paging, filtering, and sorting options. It also provides services for single SIM retrieval and CRUD operations via POST, PATCH, and DELETE actions.

The following is a sample SIM in JSON representation. Apart from its own data, the object contains an embedded endpoint object.

1{
2 "id": 788,
3 "iccid": "8988303000008013931",
4 "iccid_with_luhn": "89883030000080139311",
5 "eid": "89049011803455664400046832584675",
6 "production_date": "2014-08-01T08:47:00+0000",
7 "activation_date": "2014-08-21T18:17:00+0000",
8 "status": {
9 "id": 1,
10 "description": "Activated"
11 },
12 "customer_org": {
13 "id": 13,
14 "name": "Enterprise",
15 "country": {
16 "id": 205,
17 "name": "United Kingdom"
18 }
19 },
20 "issuer_org": {
21 "id": 11,
22 "name": "MNO",
23 "country": {
24 "id": 205,
25 "name": "United Kingdom"
26 }
27 },
28 "reseller_org": null,
29 "endpoint": {
30 "id": 1,
31 "name": "arduino01",
32 "imei": "864345678889321",
33 "created": "2015-03-19T08:45:41.000+0000",
34 "last_updated": "2015-03-19T08:45:41.000+0000",
35 "organisation_id": 5,
36 "service_profile_id": 1,
37 "tariff_profile_id": 1,
38 "tags": "arduino, meter, temp",
39 "ip_address": "10.1.1.9",
40 "ip_address_space_id": 1
41 },
42 "imsi": "123451234567890",
43 "msisdn": "88563748761",
44 "model": {
45 "id": 1,
46 "description": "Java smartcard",
47 "memory_size": 64,
48 "formfactor": {
49 "id": 1,
50 "name": "2FF",
51 },
52 "manufacturer": {
53 "id": 1,
54 "name": "Motorola"
55 }
56 }
57}

SIM object

Here is the description of SIM object:

PropertyTypeDescription
idNumberUnique identifier of this SIM
iccidStringIntegrated circuit card identifier without the final Luhn checksum digit
iccid_with_luhnStringIntegrated circuit card identifier including the final Luhn checksum digit
eidStringUnique global serial number for an eUICC if applicable
production_dateTimestamp | nullDate/time when this SIM was created
Type: ISO 8601 timestamp format
activation_dateTimestamp | nullDate/time when this SIM was activated for the first time
Type: ISO 8601 timestamp format
statusObjectInformation about the SIM status (see SIM status object)
customer_orgObjectDetails about the organization the SIM is issued to (see Customer organization object)
issuer_orgObjectDetails about the organization that issued the SIM (see Issuer organization object)
reseller_orgObject | nullDetails about the organization that resold the SIM (see Reseller organization object)
endpointObject | nullDetails about the endpoint the SIM is assigned to (see Endpoint object)
imsiString | nullIMSI number of the SIM
msisdnString | nullMSISDN number of the SIM
modelObject | nullDetails about the SIM model (see Model object)

SIM status object

PropertyTypeDescription
idNumberStatus ID for this SIM
descriptionStringDescription of the SIM status

SIM statuses

IDDescription
0Issued
1Activated
2Suspended
3Deleted
4Factory Test

Customer organization object

PropertyTypeDescription
idNumberUnique identifier of the organization
nameStringName of the organization
countryObjectCountry of the organization (see Country object)

Issuer organization object

PropertyTypeDescription
idNumberUnique identifier of the organization
nameStringName of the organization
countryObjectCountry of the organization (see Country object)

Reseller organization object

PropertyTypeDescription
idNumberUnique identifier of the organization
nameStringName of the organization
countryObjectCountry of the organization (see Country object)

Country object

PropertyTypeDescription
idIntegerUnique identifier of the country
nameStringName of country

Endpoint object

This data is embedded from a subset of the Endpoint.

PropertyTypeDescription
idIntegerUnique identifier of the endpoint
nameStringName of endpoint
imeiString | nullInternational mobile equipment identity
createdTimestampDate/time when this endpoint was created
Type: ISO 8601 timestamp format
last_updatedTimestampDate/time when this endpoint was last updated
Type: ISO 8601 timestamp format
organisation_idIntegerUnique identifier of the organization assigned to the endpoint
service_profile_idInteger | nullUnique identifier of the assigned service profile
tariff_profile_idInteger | nullUnique identifier of the assigned tariff profile
tagsString | nullAny tags assigned to this endpoint with each value separated by a comma (for example, "arduino, meter, temp")
ip_addressStringConfigured IP address
ip_address_space_idIntegerUnique identifier of the assigned IP address space

Model object

PropertyTypeDescription
idIntegerUnique identifier of the SIM model
descriptionStringDescription of the SIM model
memory_sizeIntegerMemory size in KB
formfactorObjectDetails about the SIM form factor (see Form factor object)
manufacturerObjectManufacturer of the SIM (see Manufacturer object)

Form factor object

PropertyTypeDescription
idIntegerForm factor ID for this SIM
nameStringDescription of the form factor

Manufacturer object

PropertyTypeDescription
idIntegerUnique identifier of the manufacturer
nameStringName of the manufacturer