Retrieve the organization

Fetch the organization tied to the current API key. Useful for showing plan / credits / limits in your own dashboard.

Scope: org:read

Example request

curl https://dashboard.getmacha.com/api/v1/org \
  -H "Authorization: Bearer $MACHA_API_KEY"

Example response

{
  "data": {
    "id": "org_64f1c0ef2ec711ef6dc1dcf",
    "name": "Macha AI",
    "slug": "macha-ai",
    "plan": "pro",
    "status": "active",
    "credits": {
      "total": 50000,
      "used": 12345,
      "remaining": 37655,
      "top_up": 0,
      "reset_at": "2026-07-01T00:00:00.000Z"
    },
    "limits": {
      "agents": null,
      "connectors": null,
      "sources": null,
      "chatbots": 20,
      "scheduled_triggers": 3,
      "custom_tool_slots": 5
    },
    "trial": null,
    "created_at": "2026-05-01T00:00:00.000Z"
  },
  "meta": { "request_id": "req_..." }
}

Common use cases

• Pre-flight check before bulk operations. Read credits.remaining and abort if there's not enough credit for the work you're about to do.
• Capacity planning. Compare limits.agents against your current agent count to know when you'd hit the plan cap.
• Trial expiry warnings. If trial.end_date is within the next 7 days, surface a banner in your own UI.

Errors