> For the complete documentation index, see [llms.txt](https://docs.onomondo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onomondo.com/readme/esim-profiles.md).

# eSIM profiles (SM-DP+)

## Get activation details by ICCID

> Get activation details for a SMDP+ profile by ICCID.

```json
{"openapi":"3.0.0","info":{"title":"Onomondo's API","version":"1.0.0"},"servers":[{"url":"https://api.onomondo.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"apiKey","in":"header","name":"Authorization"}}},"paths":{"/smdpp/{iccid}/activation-details":{"get":{"summary":"Get activation details by ICCID","description":"Get activation details for a SMDP+ profile by ICCID.","parameters":[{"name":"iccid","in":"path","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Bad request. Returned when:\n- `incompatible_sim_type`: SIM is not an eSIM.\n- `iccid_invalid`: ICCID doesn't match the expected format.\n","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["incompatible_sim_type","iccid_invalid"]}}}}}},"404":{"description":"Not found. Returned when:\n- `sim_not_found`: SIM was not found.\n- `esim_not_found`: eSIM was not found in Kigen.\n","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["sim_not_found","esim_not_found"]}}}}}}}}}}}
```

## Get the profile audit of a SMDP+ profile

> Get the profile audit as CSV of a SMDP+ profile by it's ICCID.

```json
{"openapi":"3.0.0","info":{"title":"Onomondo's API","version":"1.0.0"},"servers":[{"url":"https://api.onomondo.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"apiKey","in":"header","name":"Authorization"}}},"paths":{"/smdpp/{iccid}/profile-audit":{"get":{"summary":"Get the profile audit of a SMDP+ profile","description":"Get the profile audit as CSV of a SMDP+ profile by it's ICCID.","parameters":[{"name":"iccid","in":"path","schema":{"type":"string"},"required":true},{"name":"limit","in":"query","schema":{"type":"number","default":100},"required":false},{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv"],"default":"json"},"required":false}],"responses":{"200":{"description":"OK","content":{"application/json":{"type":"array","items":{"type":"object"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Bad request. Returned when:\n- `authorization_invalid`: Missing Authorization header.\n- `<field>_invalid`: the field doesn't match the expected format.\n","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["authorization_invalid","<field>_invalid"]}}}}}},"404":{"description":"Not found. Returned when:\n- `sim_not_found`: SIM was not found.\n- `incompatible_sim_type`: SIM is not an eSIM.\n","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["sim_not_found","incompatible_sim_type"]}}}}}}}}}}}
```

## Get list of activation details

> Get list of activation details by list of ICCIDs.

```json
{"openapi":"3.0.0","info":{"title":"Onomondo's API","version":"1.0.0"},"servers":[{"url":"https://api.onomondo.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"apiKey","in":"header","name":"Authorization"}}},"paths":{"/smdpp/activation-details":{"post":{"summary":"Get list of activation details","description":"Get list of activation details by list of ICCIDs.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"iccids":{"type":"array","items":{"type":"string"},"description":"The ICCIDs to get the activation details for. The maximum of 5000 ICCIDs can be used.","required":true}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Current state of the eSIM profile.","enum":["RELEASED","AVAILABLE","DISABLED","DOWNLOADED","ENABLED","INSTALLED","ERROR"]}}}}}}}}}}}
```

## Get Profile Details

> Get profile details of an eSIM.

```json
{"openapi":"3.0.0","info":{"title":"Onomondo's API","version":"1.0.0"},"servers":[{"url":"https://api.onomondo.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"apiKey","in":"header","name":"Authorization"}}},"paths":{"/smdpp/{iccid}/profile-details":{"get":{"summary":"Get Profile Details","description":"Get profile details of an eSIM.","parameters":[{"name":"iccid","in":"path","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Current state of the eSIM profile.","enum":["RELEASED","AVAILABLE","DISABLED","DOWNLOADED","ENABLED","INSTALLED","ERROR"]}}}}}}}}}}}
```