---
title: "Get user info and purchase status"
method: POST
path: "/v1/sdk/user-info"
tags: ["User Info"]
---

# Get user info and purchase status

`POST /v1/sdk/user-info`

Returns customer profile, active purchase details including usage and plan info, and a customer portal URL.

## Request body

- UserInfoRequest
  - `customerRef` string, required
  - `productRef` string, required

## Response `200`

User info with purchase status

- UserInfoResponse
  - `purchase` UserInfoPurchaseDto
    - `endDate` string, nullable
    - `plan` UserInfoPlanDto
      - `billingCycle` string, nullable
      - `currency` string, required
      - `features` string[], nullable
      - `limits` object, nullable
      - `price` number, required — Price in minor currency units (e.g. cents)
      - `reference` string, required
      - `type` string, required
    - `planType` string, required
    - `productName` string, required
    - `reference` string, required
    - `startDate` string, nullable
    - `status` string, required
    - `usage` UserInfoUsageDto
      - `meterRef` string, nullable — Meter reference
      - `percentUsed` number, nullable
      - `remaining` number, required
      - `total` number, required
      - `used` number, required
  - `status` string, required — Human-readable status summary
  - `user` UserInfoUserDto
    - `email` string, required
    - `externalRef` string, nullable
    - `name` string, nullable
    - `reference` string, required
  - `verifyUrl` string, nullable — Customer portal session URL

## Other responses

- `400` — Missing customerRef or productRef
- `404` — Customer or product not found

---

[API](https://skmtc.net/solvapay/apis/solvapay-rest-api.md) · [All operations](https://skmtc.net/solvapay/apis/solvapay-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solvapay/solvapay-rest-api/revisions/bbc2ff2bc849/schema)