Skip to content

Getting Started

This guide takes you from zero to your first authenticated API call. Once you have a partner account it takes only a few minutes: create an API key, then send an authenticated request with your X-Api-Key header.

1. Get access

The PartnerHub API is available to PartnerHub partners. If your company already has a partner account, sign in to the partner portal. If not, contact PartnerHub to be onboarded as a partner — you'll receive a login for the partner portal, where you manage your API keys.

2. Create an API key

Every request is authenticated with an API key. You create and manage keys yourself in the partner portal. We recommend starting with a Sandbox key so you can build and test without touching live data.

  1. Sign in to the partner portal and open API access.
  2. Choose the Sandbox environment and create a new key.
  3. Copy the key immediately — it's shown only once and can't be retrieved later. Store it as a secret (an environment variable or your secrets manager), never in client-side code or version control.

Need to replace a key later? See Key rotation on the Authentication page.

3. Make your first call

With your key in hand, make your first authenticated request. The calculate endpoint prices a product for leasing or rent-to-own — it creates nothing, so it's a safe first call. Send your key in the X-Api-Key header against the Sandbox base URL (https://sandbox.partner.miete24.com/api). 

curl -X POST 'https://sandbox.partner.miete24.com/api/calculate' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "acquisitionCost": 1000,
    "productSector": "IT_AND_OFFICE_EQUIPMENT",
    "paymentInterval": "monthly",
    "calculationTypes": ["leasing"],
    "durations": [36]
  }'
Response 200 (truncated) 
{
  "@id": "/api/calculations/2b1c9d7e-4f6a-4c2e-9b1a-8d3f5e7c1a2b",
  "id": "2b1c9d7e-4f6a-4c2e-9b1a-8d3f5e7c1a2b",
  "response": {
    "offers": [
      { "duration": 36, "calculationType": "leasing", "rate": 32.90 }
    ]
  }
}

A 200 response with offers means your key works. A 401 means the key is missing or invalid — check the X-Api-Key header.

Full parameters & all operations → Calculation reference

What's next