PressOne eSIM Developer Platform
  1. Manage eSIMs
PressOne eSIM Developer Platform
  • OVERVIEW
    • Introduction
    • Attribute descriptions
    • FAQ
    • User journeys
      • Top-up Journey
      • Purchase Journey
    • Guides
      • eSIM installation methods for API Partners
      • How to generate the QR code for an eSIM
  • REST API
    • Data / Data + Voice + SMS eSIM
      • Introduction
      • Error handling
      • Endpoints
        • Authenticate
          • Request access token
        • Check balance
          • Get balance
        • Compatible devices
          • Get compatible device lite list
        • Browse packages
          • Get packages
        • Place order
          • Submit order
        • Install eSIM
          • Get eSIM
          • Get installation instructions
        • Monitor usage
          • Get usage (data, text & voice)
        • Place top up order
          • Get top-up package list
          • Submit top-up order
        • Manage orders
          • Get order list
          • Get order
        • Manage eSIMs
          • Get eSIMs list
            GET
          • Get eSIM package history
            GET
    • Voice-only eSIM
      • Getting Started
      • Error handling
      • Endpoints
        • List Available Numbers
        • Claim Number
        • Renew Number
        • List User
  1. Manage eSIMs

Get eSIMs list

GET
/customer/v2/sims
šŸ’”
GDPR and Data Storage
For compliance with GDPR and global privacy regulations, PressOne does not store any of your end-users' personally identifiable information (PII). You are solely responsible for handling and storing all customer data on your end.
Associating eSIMs with Customers
To retrieve or manage all eSIMs associated with a specific customer, you must store and map the customer's data to the ICCID within your own system. The ICCID is the primary identifier for managing an eSIM post-purchase.
This endpoint allows you to retrieve a list of your eSIMs from the PressOne eSIM API. You can customize the results using various filters and include related data in the response by specifying optional parameters.
The access token, obtained from the "Request Access Token" endpoint, should be included in the request.
direct_apple_installation_url: Partner API now supports direct installation on iOS devices. With the introduction of Universal Links by Apple, users with iOS 17.4 or higher can directly install eSIMs using a special URL, which can be provided to your end clients if they are using iOS version 17.4 or above.

Request

Query Params

Header Params

Responses

🟠422eSIMs List (422)
application/json
Body

🟢200eSIMs List (200)
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://prod.your-api-server.com/customer/v2/sims?include=order,order.user,share&filter[created_at]=Y-m-d - Y-m-d&filter[iccid]=8944465400000217735&page=1&per-page=50' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{token}}'
Response Response Example
422 - eSIMs List (422)
{
    "data": {
        "limit": "The limit must be an integer."
    },
    "meta": {
        "message": "the parameter is invalid"
    }
}
Modified atĀ 2025-11-16 23:19:56
Previous
Get order
Next
Get eSIM package history
Built with