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.

Mapping.Travel organizes access into three plan tiers. Your plan determines how many mapping jobs your organization can run per day and how many suppliers you can connect. Limits are enforced per organization, so all team members share the same quota. You can view available plans and your current subscription at any time, and upgrade or manage your plan through Stripe.

​
Available plans

Free

  • 10 mappings per day
  • 5 suppliers maximum
  • No monthly cost
  • Credits available as top-ups

Subscription

  • Higher daily mapping limit
  • More supplier connections
  • Fixed monthly price
  • Credits available as top-ups

Enterprise

  • Custom mapping limits
  • Unlimited supplier connections
  • Custom pricing
  • Priority support
Plan limits apply at the organization level. All users in your organization share the same daily mapping quota and supplier allowance.

​
View all plans

Call GET /api/v1/billing/plans to retrieve all available plan tiers with their features and pricing. The response includes your current plan so you can compare it against other options. 
curl https://api.mapping.travel/api/v1/billing/plans \
  -H "Authorization: Bearer <your-token>"
Example response: 
{
  "tiers": [
    {
      "planType": "FREE",
      "displayName": "Free",
      "monthlyPrice": "Free",
      "mappingsPerDay": 10,
      "maxSuppliers": 5,
      "pricePerMillion": null,
      "features": ["10 mappings/day", "5 suppliers"]
    },
    {
      "planType": "SUBSCRIPTION",
      "displayName": "Subscription",
      "monthlyPrice": "€49/month",
      "mappingsPerDay": 10000,
      "maxSuppliers": 50,
      "pricePerMillion": "€1/M",
      "features": ["10000 mappings/day", "50 suppliers", "Monthly subscription"]
    },
    {
      "planType": "ENTERPRISE",
      "displayName": "Enterprise",
      "monthlyPrice": "€499/month",
      "mappingsPerDay": 1000000,
      "maxSuppliers": 500,
      "pricePerMillion": "€1/M",
      "features": ["1000000 mappings/day", "500 suppliers", "Monthly subscription"]
    }
  ],
  "credits": {
    "name": "Pay as you go",
    "description": "Pay per use - €1 per 1 million mappings",
    "pricePerMillion": "€1",
    "minimumCredits": 5000000
  },
  "currentPlan": "FREE"
}

​
View your current subscription

Call GET /api/v1/billing/subscription to retrieve details about your active subscription, including its status, billing period, and whether it is set to cancel at period end. 
curl https://api.mapping.travel/api/v1/billing/subscription \
  -H "Authorization: Bearer <your-token>"
Example response: 
{
  "planType": "SUBSCRIPTION",
  "status": "ACTIVE",
  "currentPeriodStart": "2026-04-01T00:00:00Z",
  "currentPeriodEnd": "2026-05-01T00:00:00Z",
  "cancelAtPeriodEnd": false,
  "stripeSubscriptionId": "sub_1Abc123"
}
Possible status values are ACTIVE, TRIALING, PAST_DUE, CANCELED, INCOMPLETE, and UNPAID.

​
Upgrade your plan

To upgrade, create a Stripe checkout session with POST /api/v1/billing/checkout. Pass the stripePriceId from the plan tier you want to move to. Redirect your user to the returned url to complete payment.
1

Get the price ID for your target plan

Call GET /api/v1/billing/plans and copy the stripePriceId from the plan tier you want.
2

Create a checkout session

curl -X POST https://api.mapping.travel/api/v1/billing/checkout \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "stripePriceId": "price_1ABCxyz",
    "successUrl": "https://yourapp.com/billing/success",
    "cancelUrl": "https://yourapp.com/billing/cancel"
  }'
3

Redirect to the checkout URL

The response contains a url field. Redirect your user to that URL to complete the Stripe checkout. Once payment succeeds, your plan upgrades automatically.
{
  "url": "https://checkout.stripe.com/pay/cs_live_...",
  "sessionId": "cs_live_..."
}

​
Manage your subscription

To cancel, update payment details, or download invoices, open the Stripe customer portal with POST /api/v1/billing/portal. Redirect your user to the returned URL. 
curl -X POST https://api.mapping.travel/api/v1/billing/portal \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "returnUrl": "https://yourapp.com/billing"
  }'
Example response: 
{
  "url": "https://billing.stripe.com/session/..."
}
Use the Stripe portal to update your payment method, view past invoices, or cancel your subscription before the next billing cycle.