# Get an eSIM

## Get eSIM by ICCID

> Returns the Subscription information associated with the provided ICCID.

```json
{"openapi":"3.0.0","info":{"title":"Filtered eSIM API","version":"1.0"},"paths":{"/api/v1/eSIM/getByIccid/{iccid}":{"get":{"description":"Returns the Subscription information associated with the provided ICCID.","operationId":"getProfileByIccid","parameters":[{"description":"The ICCID to retrieve the profile data for.","in":"path","name":"iccid","required":true,"schema":{"maxLength":20,"minLength":19,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"properties":{"activationCode":{"description":"The activation code associated with the ICCID.","type":"string"},"iccid":{"description":"ICCID with the checksum removed","type":"string"},"imei":{"description":"The IMEI associated with the device.","type":"string"},"imsi":{"description":"The IMSI (International Mobile Subscriber Identity) associated with the ICCID.","type":"string"},"matchingId":{"description":"A matching identifier for the profile.","type":"string"},"qr_code":{"description":"The QR code associated with the profile.","type":"string"},"state":{"description":"The state of the profile.","type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successfully fetched profile information for the given ICCID."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"description":"Error message indicating validation failure or incorrect input.","type":"string"}},"type":"object"}}},"description":"Bad request, invalid ICCID format or validation failure."},"500":{"content":{"application/json":{"schema":{"properties":{"error":{"description":"Error message describing what went wrong.","type":"string"}},"type":"object"}}},"description":"Internal server error, failed to fetch profile or other issues."}},"summary":"Get eSIM by ICCID","tags":["eSIM"]}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.monogoto.io/developer/api/esim/get-an-esim.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.