Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mappingtravel.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Credits give your organization extra mapping capacity on top of your plan’s daily limit. When your organization exhausts its daily quota, each additional mapping job consumes one credit. Credits are purchased separately from your subscription, never expire, and are shared across all users in your organization.

​
How credits work

Your plan includes a fixed number of mapping jobs per day. Once you reach that limit, the API does not reject requests — instead, it draws from your credit balance. One credit is deducted for each mapping job that runs beyond the daily quota. Credits are priced at €1 per 1,000,000 mappings. The minimum purchase is 5,000,000 credits (€5). Credits do not expire and carry over month to month.
Credits are shared at the organization level. All team members draw from the same credit pool.

​
Check your credit balance

Call GET /api/v1/billing/credits/balance to see how many credits your organization has remaining. 
curl https://api.mapping.travel/api/v1/billing/credits/balance \
  -H "Authorization: Bearer <your-token>"
Example response: 
{
  "creditsRemaining": 4750000,
  "creditsUsed": 250000,
  "totalSpent": 0.25
}
FieldDescription
creditsRemainingCredits available to use right now
creditsUsedTotal credits consumed since your last purchase
totalSpentTotal amount spent on credits (in euros)

​
Purchase credits

Call POST /api/v1/billing/credits/purchase to buy more credits. Pass the number of credits you want and your redirect URLs. The response contains a Stripe checkout URL — redirect your user there to complete payment. 
curl -X POST https://api.mapping.travel/api/v1/billing/credits/purchase \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "credits": 10000000,
    "successUrl": "https://yourapp.com/billing/success",
    "cancelUrl": "https://yourapp.com/billing/cancel"
  }'
Example response: 
{
  "url": "https://checkout.stripe.com/pay/cs_live_...",
  "sessionId": "cs_live_...",
  "credits": 10000000,
  "totalCost": "€10.00"
}
The minimum purchase is 5,000,000 credits. Requests for fewer credits will be rejected.
If you regularly exceed your daily plan limit, consider upgrading to the Subscription or Enterprise plan for a higher base quota rather than relying solely on credits.