Skip to content
MeeShip logo
MeeShip

Usage

GET /api/v1/usage — current credit balance + daily usage breakdown for the current pack's validity window.

Authentication: required.

Response — 200 OK#

JSON
{
  "tier": "starter",
  "status": "active",
  "credits_remaining": 87,
  "credits_granted_this_cycle": 100,
  "cycle_started_at": "2026-05-12T00:00:00Z",
  "cycle_ends_at": "2026-06-11T00:00:00Z",
  "rate_limit_per_min": 2,
  "grace_period_ends_at": null,
  "daily": [
    {
      "date": "2026-05-26",
      "calls": 14,
      "successes": 13,
      "failures": 1,
      "credits_used": 13
    }
  ]
}

Field notes#

FieldNotes
tierThe internal tier identifier (free_trial / starter / pro / enterprise) that sets your rate-limit cap. Maps to the public pack names — Developer (starter), Growth (pro), Scale (enterprise).
statusactive, past_due (in grace), cancelled, or expired.
credits_remainingLive count. Decrements as jobs complete.
credits_granted_this_cycleTotal credits granted across all packs in the current window — useful for usage gauges.
cycle_ends_atWhen unused credits expire. Buying another pack extends this to the later of (current expiry, now + new pack's validity).
daily[]Most recent 60 days, newest first. failures includes both 4xx and 5xx; credits_used only counts billable completions.

Buying more credits#

When you run out (402 quota_exhausted) or your cycle_ends_at is approaching, buy another credit pack from your dashboard: https://meeship.in/dashboard/api.

Packs available:

PackPriceCreditsValidityEffective
Developer₹99910030 days~₹10/call
Growth₹3,99950060 days~₹8/call
Scale₹12,0002,00090 days₹6/call

Need more than 2,000 credits, custom SLA, or volume pricing? Email meeship.seller@gmail.com.

Credits stack:

  • A new pack's credits add to your existing balance.
  • Expiry extends to the later of (current expiry, now + new pack validity).
  • Buying a higher-tier pack raises your rate limit (never lowers it).

Snippets#

Shell
curl -H "Authorization: Bearer meeship_live_..." \
     https://api.meeship.in/api/v1/usage
Python
import requests
r = requests.get(
    "https://api.meeship.in/api/v1/usage",
    headers={"Authorization": "Bearer meeship_live_..."},
)
u = r.json()
print(f"Tier: {u['tier']}  •  Credits: {u['credits_remaining']}/{u['credits_granted_this_cycle']}")