> For the complete documentation index, see [llms.txt](https://docs.eseye.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eseye.com/api-reference/sim-api/network-snapshot/view-the-network-snapshot-for-a-specific-sim.md). # View the network snapshot for a specific SIM Returns the current network state of a SIM: the network it is attached to, the device it is installed in, the cell tower it last connected through, and its most recent data session. The snapshot is collated periodically, so `updateTime` tells you how current each section is. ```json {"openapi":"3.1.0","info":{"title":"AnyNet SIM API","version":"2.0.0"},"tags":[{"name":"Network snapshot"}],"servers":[{"url":"https://sim.api.anynetiot.com","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"An OAuth 2.0 client credentials access token, sent as `Authorization: Bearer `.\n\nRequest the token from `https://eseye-idp-prod.auth.eu-west-1.amazoncognito.com/oauth2/token` using the client ID and client secret Eseye supplied. Tokens expire after one hour."}},"parameters":{"iccId":{"name":"iccId","in":"path","required":true,"description":"The ICC ID of the SIM.","schema":{"type":"string"}}},"schemas":{"NetworkSnapshot":{"type":"object","description":"The current network, device, location, and data session state of a SIM.","properties":{"iccId":{"type":"string","description":"The ICC ID of the SIM.","maxLength":20},"simId":{"type":"string","description":"The unique identifier for the SIM.","maxLength":32},"network":{"type":"object","description":"The network the SIM is attached to.","properties":{"imsi":{"type":"string","description":"The most recent IMSI the SIM used to connect to a network.","maxLength":90},"rat":{"type":"string","description":"The most recent radio access technology the SIM used, for example `LTE-M` or `UTRAN`.","maxLength":32},"lai":{"type":"string","description":"The location area identity, in hexadecimal."},"ci":{"type":"string","description":"The cell identity, in hexadecimal."},"mcc":{"type":"string","description":"The ISO 3166-1 numeric mobile country code of the most recent network.","maxLength":4},"mnc":{"type":"string","description":"The mobile network code of the most recent network.","maxLength":4},"updateTime":{"type":"string","description":"When this section of the snapshot was collated. All times are UTC."}}},"device":{"type":"object","description":"The device the SIM is installed in.","properties":{"imei":{"type":"string","description":"The IMEI of the device the SIM is installed in.","maxLength":100},"updateTime":{"type":"string","description":"When this section of the snapshot was collated."}}},"location":{"type":"object","description":"The cell tower the SIM most recently connected through. This is not the GPS position of the device.","properties":{"lat":{"type":"string","description":"The latitude of the cell tower.","maxLength":30},"lon":{"type":"string","description":"The longitude of the cell tower.","maxLength":30},"updateTime":{"type":"string","description":"When this section of the snapshot was collated."}}},"data":{"type":"object","description":"The most recent data session recorded for the SIM.","properties":{"apn":{"type":"string","description":"The access point name the session used.","maxLength":32},"ip":{"type":"string","description":"The IP address the device used."},"username":{"type":"string","description":"The user that most recently authenticated on the APN.","maxLength":32},"startTime":{"type":"string","description":"When the session started."},"stopTime":{"type":"string","description":"When the session stopped."},"updateTime":{"type":["string","null"],"description":"When this section of the snapshot was collated."}}},"portfolioPackage":{"type":"object","description":"The portfolio and package the SIM is assigned to.","properties":{"portfolioId":{"type":"string","description":"The portfolio the SIM is assigned to.","maxLength":32},"packageId":{"type":"string","description":"The package applied to the SIM."}}},"attributes":{"type":"array","description":"The attributes attached to the SIM.","items":{"$ref":"#/components/schemas/SimAttribute"}}}},"SimAttribute":{"type":"object","properties":{"iccAttributeId":{"type":"integer","description":"The unique identifier for the attribute."},"iccId":{"type":"string","maxLength":20,"description":"The SIM the attribute belongs to."},"attribute":{"type":"string","maxLength":48,"description":"The attribute name. Names cannot contain spaces."},"value":{"type":"string","maxLength":255,"description":"The attribute value. Can be an empty string, but not `null`."},"status":{"$ref":"#/components/schemas/RecordStatus"}},"description":"A name/value pair attached to a SIM."},"RecordStatus":{"type":"string","description":"Whether the record is still attached to its parent object.\n\n| Value | Meaning |\n| --- | --- |\n| `active` | The record is attached to the parent object. |\n| `deleted` | The record is no longer attached to the parent object. |","enum":["active","deleted"]},"Error":{"type":"object","properties":{"errorCode":{"type":"integer","description":"The Eseye error code.\n\n| Code | Meaning |\n| --- | --- |\n| `6001` | Your service account does not have permission for this operation. |\n| `6002` | An object referenced in the request does not exist. |\n| `6003` | The request method is wrong or missing. |\n| `6004` | The server could not be reached. Check the request URL and your connection. |\n| `6006` | The request is malformed. A mandatory field is missing, a data type is wrong, a value is too long, or the JSON is invalid. |\n| `6007` | You do not have permission to make this status transition. |"},"errorTag":{"type":"string","description":"A short error name. Contains no spaces."},"message":{"type":"string","description":"A short description of the error."},"additionalDetails":{"type":"object","description":"Names the object that could not be resolved, or lists the fields that failed validation."}},"description":"An error returned by the API."}},"responses":{"BadRequest":{"description":"The request contained an invalid parameter. `additionalDetails` lists the fields that failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The token is valid, but the service account does not have permission for this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"An entity referenced in the request does not exist. The `message` and `additionalDetails` name what could not be resolved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v2/sim/{iccId}/networkSnapshot":{"get":{"summary":"View the network snapshot for a specific SIM","operationId":"view-network-snapshot-for-a-specific-sim","tags":["Network snapshot"],"parameters":[{"$ref":"#/components/parameters/iccId"}],"responses":{"200":{"description":"The network snapshot for the SIM.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkSnapshot"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"description":"Returns the current network state of a SIM: the network it is attached to, the device it is installed in, the cell tower it last connected through, and its most recent data session.\n\nThe snapshot is collated periodically, so `updateTime` tells you how current each section is."}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.eseye.com/api-reference/sim-api/network-snapshot/view-the-network-snapshot-for-a-specific-sim.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.