Users

cURL Ruby

List all users

GET /users(.:format)

Returns a list of users within the administration.

Parameters

Parameter Type Description
include_accountants Boolean
include_inactive Boolean

Example: returns all active users of an administration

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/users.json?

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "451599656313423417",
    "name": "John Doe",
    "created_at": "2025-04-17T14:10:15.244Z",
    "updated_at": "2025-04-17T14:10:15.254Z",
    "email": "john+3@doe.nl",
    "email_validated": true,
    "language": "nl",
    "time_zone": "Europe/Amsterdam",
    "user_type": "employee",
    "permissions": [
      "time_entries"
    ]
  },
  {
    "id": "451599357521692620",
    "name": "Mo Neybird",
    "created_at": "2025-04-17T14:05:30.295Z",
    "updated_at": "2025-04-17T14:05:30.488Z",
    "email": "info@moneybird.nl",
    "email_validated": true,
    "language": "nl",
    "time_zone": "Europe/Amsterdam",
    "user_type": "owner",
    "permissions": [
      "sales_invoices",
      "documents",
      "estimates",
      "bank",
      "settings",
      "ownership",
      "time_entries"
    ]
  }
]

Example: only includes permission for users with this administration

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/users.json?

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "451599656488535611",
    "name": "A. Arend.",
    "created_at": "2025-04-17T14:10:15.406Z",
    "updated_at": "2025-04-17T14:10:15.731Z",
    "email": "john+3@doe.nl",
    "email_validated": true,
    "language": "nl",
    "time_zone": "Europe/Amsterdam",
    "user_type": "employee",
    "permissions": [
      "time_entries"
    ]
  },
  {
    "id": "451599357521692620",
    "name": "Mo Neybird",
    "created_at": "2025-04-17T14:05:30.295Z",
    "updated_at": "2025-04-17T14:05:30.488Z",
    "email": "info@moneybird.nl",
    "email_validated": true,
    "language": "nl",
    "time_zone": "Europe/Amsterdam",
    "user_type": "owner",
    "permissions": [
      "sales_invoices",
      "documents",
      "estimates",
      "bank",
      "settings",
      "ownership",
      "time_entries"
    ]
  }
]

Example: includes accounts when include_accountants is true

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/users.json?include_accountants=true

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "451599656928937585",
    "name": "A. Accountant.",
    "created_at": "2025-04-17T14:10:15.832Z",
    "updated_at": "2025-04-17T14:10:15.849Z",
    "email": "john+3@doe.nl",
    "email_validated": true,
    "language": "nl",
    "time_zone": "Europe/Amsterdam",
    "user_type": "accountant",
    "permissions": [
      "sales_invoices",
      "documents",
      "estimates",
      "bank",
      "settings",
      "time_entries"
    ]
  },
  {
    "id": "451599357521692620",
    "name": "Mo Neybird",
    "created_at": "2025-04-17T14:05:30.295Z",
    "updated_at": "2025-04-17T14:05:30.488Z",
    "email": "info@moneybird.nl",
    "email_validated": true,
    "language": "nl",
    "time_zone": "Europe/Amsterdam",
    "user_type": "owner",
    "permissions": [
      "sales_invoices",
      "documents",
      "estimates",
      "bank",
      "settings",
      "ownership",
      "time_entries"
    ]
  }
]

Example: includes inactive users when include_inactive is true

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/users.json?include_inactive=true

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "451599357521692620",
    "name": "Mo Neybird",
    "created_at": "2025-04-17T14:05:30.295Z",
    "updated_at": "2025-04-17T14:05:30.488Z",
    "email": "info@moneybird.nl",
    "email_validated": true,
    "language": "nl",
    "time_zone": "Europe/Amsterdam",
    "user_type": "owner",
    "permissions": [
      "sales_invoices",
      "documents",
      "estimates",
      "bank",
      "settings",
      "ownership",
      "time_entries"
    ]
  },
  {
    "id": "451599657076786803",
    "name": "A. User.",
    "created_at": "2025-04-17T14:10:15.972Z",
    "updated_at": "2025-04-17T14:10:15.988Z"
  }
]