1. Card service interfaces
EIOTCLUB API
  • API Interface
    • Interface Description
    • Signature algorithm
    • Error Code
    • Card service interfaces
      • Query all cards under account (Deprecated)
        POST
      • Single Card Information Query (Deprecated)
        POST
      • Query Batch Card
        POST
      • Query Card Package Order Records
        POST
      • Query available packages for a card
        POST
      • Single Card Refresh (Deprecated)
        POST
      • Query international card warning information under the account
        POST
      • Card total statistics
        POST
      • Query profit sharing information at the current level
        POST
      • Query the list of operators that the card can switch to
        POST
      • Switch the operator of the card
        POST
      • Unlock the IMEI pool of the card
        POST
      • Add IMEI to the IMEI card pool
        POST
      • Send SMS
        POST
      • Query the refundable amount
        POST
      • Query customer account balance
        POST
      • Query the status of a package subscription order
        POST
      • Query the product to which the card belongs
        POST
      • Query the orderable packages under the specified product
        POST
      • Query orderable eSIM products
        POST
      • Purchase eSIM
        POST
      • Refund an eSIM order
        POST
      • Query eSIM order details
        POST
      • Query the refundable amount of an eSIM order
        POST
      • Query the details of the package corresponding to the order
        POST
      • Card bind device
        POST
      • Card unbind device
        POST
      • Card Transfer Package
        POST
      • Refresh package usage
        POST
      • Cancel current session
        POST
      • Query the seed number list of the eUICC card
        POST
      • Deliver eSIM remotely
        POST
      • Query all profiles under eUICC
        POST
      • Query Switchable Products for the Card
        POST
      • Switch Card Product
        POST
    • Card package subscription interfaces
      • Package subscription interface
      • Package refund interface
    • Asynchronous notification
      • Traffic alert
      • Unlock notification
      • Card locking notification
      • Subscription notification
      • Subscription notification - detailed version
      • Package activation notice
      • Product switching
      • Refund notification
      • Notification of package expiration upon reaching usage limit
      • Notification of card network disconnection
      • Notification of card being removed from the IMEI pool
      • Notification of card being moved into the IMEI pool
      • Notification of agent pool deact pkg
      • Notification of agent pool pkg activate
      • Notification of agent pool pkg traffic alert
      • EIM remote operation result notification
    • Cloud eSIM
      • Query all cloud eSIM cards under account
      • Single Cloud eSIM Card Details
      • Query Available Packages for Cloud eSIM Card
      • Query cloud eSIM card subscription records
      • Refresh eSIM card under account
      • Purchase eSIM card plan under account
      • Cloud eSIM card order status under account
      • Refund for Cloud eSIM Card Orders Under the Account
      • Query Refundable Amount for Cloud eSIM Card Orders Under the Account
      • Cloud eSIM Transfer Package
      • Cloud eSIM unlock
      • Query Switchable Products for the Cloud eSIM Card
      • Switch Cloud eSIM Card Product
      • Batch Add Cloud eSIM EIDs to IMEI Pool
    • Cloud eSIM Asynchronous notification
      • Traffic alert
      • Subscription notification
      • Package activation notice
      • Refund notification
      • Notification of package expiration upon reaching usage limit
      • Notification of card network disconnection
      • Product switching
      • Card locked notification
      • Card unlocked notification
    • Pool
      • Get pool package list
      • Create pool
      • Get pool list
      • Delete empty pool
      • Subscribe pool package
      • Get pool record list
      • Unsubscribe pool package
      • Get pool's can add card
      • Add pool's card
      • Get pool's card list
      • Remove pool's card
      • Get pool by iccid
    • CDR
      • Batch Query ICCID Traffic
  1. Card service interfaces

Single Card Refresh (Deprecated)

Deprecated
POST
/api/v3/card/refreshCard
Refresh card information based on the card number.
Deprecate this interface after 22/10/2025. If you need to refresh the card package usage, please use the Refresh package usage interface. If you want to cancel the current session and reconnect the card, please use the Cancel current session interface.

Request

Body Params application/json

Example
{
    "operator": 5,
    "appkey": "{{APPKEY}}",
    "timestamp": {{TIMESTAMP}},
    "nonce": 90174,
    "sign": "{{SIGN}}",
    "iccid": "8988308650100524999",
    "packageCode": "CN-5M-7D-C-US-20230103AC4BF927",
    "startType": "0",
    "outTradeNo": "810000200804035522"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://oapi.eiotclub.com/api/v3/card/refreshCard' \
--header 'Content-Type: application/json' \
--data '{
    "operator": 5,
    "appkey": "",
    "timestamp": ,
    "nonce": 90174,
    "sign": "",
    "iccid": "8988308650100524999",
    "packageCode": "CN-5M-7D-C-US-20230103AC4BF927",
    "startType": "0",
    "outTradeNo": "810000200804035522"
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "code": "200",
    "message": "Operation successful"
}
Modified at 2026-05-18 07:34:35
Previous
Query available packages for a card
Next
Query international card warning information under the account
Built with