Skip to main content
POST
/
v1
/
sdk
/
user-info
Get user info and purchase status
curl --request POST \
  --url https://api.example.com/v1/sdk/user-info \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerRef": "cus_3C4D5E6F",
  "productRef": "prd_1A2B3C4D"
}
'
{
  "status": "Active subscription: My API Product (25% usage consumed)",
  "purchase": {
    "planType": "recurring",
    "productName": "My API Product",
    "reference": "pur_1A2B3C4D",
    "status": "active",
    "endDate": "2025-11-27T10:00:00Z",
    "plan": {
      "currency": "USD",
      "price": 2999,
      "reference": "pln_2B3C4D5E",
      "type": "recurring",
      "billingCycle": "monthly",
      "features": [
        "<string>"
      ],
      "limits": {}
    },
    "startDate": "2025-10-27T10:00:00Z",
    "usage": {
      "remaining": 750,
      "total": 1000,
      "used": 250,
      "meterId": "507f1f77bcf86cd799439011",
      "percentUsed": 25
    }
  },
  "user": {
    "email": "john@example.com",
    "reference": "cus_3C4D5E6F",
    "externalRef": "auth_user_12345",
    "name": "John Doe"
  },
  "verifyUrl": "https://solvapay.com/customer/manage?id=abc123"
}

Body

application/json
customerRef
string
required

Customer reference

Example:

"cus_3C4D5E6F"

productRef
string
required

Product reference

Example:

"prd_1A2B3C4D"

Response

User info with purchase status

status
string
required

Human-readable status summary

Example:

"Active subscription: My API Product (25% usage consumed)"

purchase
object
user
object
verifyUrl
string | null

Customer portal session URL

Example:

"https://solvapay.com/customer/manage?id=abc123"