API quickstart
By the end of this tutorial you will have made an API call to Solvimon and received a response. No billing setup required — just get talking to the API.
What you’ll need:
- A Solvimon sandbox account
curlor any HTTP client
Step 1: Get your API key
- Log in to the Solvimon Sandbox
- Go to Developers → API keys and click Add API key
- Enter a Description, click Generate and copy the key. You cannot view it again after you close the dialog.
Keep your API key secret. Do not commit it to source control or expose it in client-side code.
Step 2: Make your first request
List your customers. On a fresh sandbox account this returns an empty list — that’s expected.
A successful response:
A 200 with an empty data array means you’re authenticated and connected.
Step 3: Create your first customer
Response:
The id is Solvimon’s internal identifier. The reference is your own — use it to look this customer up from your system.
Step 4: Fetch the customer back
Step 5: Activate the customer
The customer was created in DRAFT status. Before you can create a subscription, you need to activate them:
A 200 response means the customer is now ACTIVE. Resources in Solvimon follow a DRAFT → ACTIVE lifecycle — drafts exist so you can configure them before they’re used in billing.
All API requests must be made over HTTPS. Requests without a valid X-API-KEY header return 401 UNAUTHORISED.
X-API-KEY header return 401 UNAUTHORISED.What to do next
- Build a complete billing setup — Configure your first meters and prices walks through the complete primitive chain: meter → product → pricing plan → subscription → usage event → invoice.
- Build a B2C subscription product — Bill your first B2C customer adds payment collection via Adyen or Stripe.
- Understand the flow — Onboarding guide covers the setup sequence at a high level.