Get organisation details

GEThttps://app.speybooks.com/api/v1/admin/orgs/{id}

A full view of one organisation: details, all linked users with their roles, usage statistics (invoices, contacts, transactions), and the twenty most recent audit-log entries scoped to that organisation.

Path parameters

idstringrequired

Organisation ID.

Response

200360-degree org view: subscription, users, usage stats, and recent audit activity.

Show response fields

organisationobject

Show child attributes

idstring

namestring

planstring

slugstring

stripeCustomerIdstring

stripeSubscriptionIdstring

subscriptionStatusstring

recentActivityarray<object>

statsobject

Show child attributes

contactsinteger

invoicesinteger

transactionsinteger

usersarray<object>

Show child attributes

emailstring

fullNamestring

idinteger

isActiveboolean

rolestring

totpEnabledboolean

Error codes

404Organisation not found.

RequestGET/v1/admin/orgs/{id}curl

curl https://api.speybooks.com/v1/admin/orgs/uuid-here \
  -H "Authorization: Bearer <admin-token>"

Response200

{
  "success": true,
  "data": {
    "organisation": {
      "id": "uuid",
      "name": "Acme Ltd",
      "slug": "acme-ltd",
      "plan": "sole_trader",
      "subscriptionStatus": "active",
      "stripeCustomerId": "cus_abc",
      "stripeSubscriptionId": "sub_xyz"
    },
    "users": [
      {
        "id": 1,
        "email": "jane@example.com",
        "fullName": "Jane Doe",
        "role": "owner",
        "isActive": true,
        "totpEnabled": true
      }
    ],
    "stats": {
      "invoices": 42,
      "contacts": 15,
      "transactions": 312
    },
    "recentActivity": []
  }
}