Buy Plan

The Buy SIM API allows you to purchase SIM cards or eSIM profiles directly from the 1PSIM platform. This endpoint is used by reseller and wholesale partners to order inventory for activation and distribution to end users.

With this API, you can:

• Purchase physical SIM cards to be shipped to your address

• Instantly issue eSIM profiles, which are ready to activate and deliver digitally

• Specify quantity, SIM type (SIM/eSIM), and optional configuration preferences

This API is designed to support real-time transactions and can be fully automated within your backend system or order workflow.

⚠️ Note: You must have sufficient credits to purchase SIMs via API

In the following sections, you'll find:

• Request structure and parameters

• Example request and response

• Common errors and how to handle them

• Fulfillment details (for physical SIMs)

Purchase a Physical SIM or eSIM

POST /subscriber/sim/purchase

This endpoint allows partners to purchase one or more physical SIM cards or eSIM profiles. Upon successful purchase:

• Physical SIMs will be registered and queued for shipment or inventory allocation.

• eSIMs will be immediately available and returned with their activation details (e.g., QR code or SM-DP+ address/profile).

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
paymentGateway	string	Must be "balance"
planPricingIds	string[]	This is the Plan(s) you want to purchase. Each Plan may have different cost for different duration.
shippingFirstName	string	If your purchased Plan is a Physical SIM plan, then you need to provide First Name for delivery.
shippingLastName	string	If your purchased Plan is a Physical SIM plan, then you need to provide Last Name for delivery.
shippingPhoneNumber	string	If your purchased Plan is a Physical SIM plan, then you need to provide Phone Number for delivery.
shippingAddress1	string	If your purchased Plan is a Physical SIM plan, then you need to provide Address for delivery.
shippingAddress2	string	If your purchased Plan is a Physical SIM plan, then you need to provide Address for delivery.
shippingCity	string	If your purchased Plan is a Physical SIM plan, then you need to provide City for delivery.
shippingState	string	If your purchased Plan is a Physical SIM plan, then you need to provide State for delivery.
shippingCountry	string	If your purchased Plan is a Physical SIM plan, then you need to provide Country for delivery.
shippingZipcode	string	If your purchased Plan is a Physical SIM plan, then you need to provide Zip code for delivery.
shippingRateId	string	If your purchased Plan is a Physical SIM plan, then you need to select one of the supported Shipping Method.
zipCodeActivation	string	T-Mobile SIM requires a US zip code for activating your SIM.

Example Request

curl -X 'POST' \
  'https://1psim.api.lifeline.mobi/subscriber/sim/purchase' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "paymentGateway": "balance",
  "planPricingIds": [
    "string"
  ],
  "shippingFirstName": "string",
  "shippingLastName": "string",
  "shippingPhoneNumber": "string",
  "shippingAddress1": "string",
  "shippingAddress2": "string",
  "shippingCity": "string",
  "shippingState": "string",
  "shippingCountry": "string",
  "shippingZipcode": "string",
  "shippingRateId": "string",
  "zipCodeActivation": "string"
}'

Response

200

{
  "statusCode": 200,
  "message": "SUCCESS: The sim has been successfully purchased."
}

401

{
  "statusCode": 401,
  "message": "Unauthorized"
}

400

{
  "statusCode": 400,
  "message": "PLAN_NOT_ACTIVE: The one or more plan/s you requested is not active.

}

404

{
  "statusCode": 404,
  "message": "PLAN_NOT_ACTIVE: The one or more plan/s you requested is not active."


}