Users

cURL Ruby

List all active users

GET /users(.:format)

Returns a list of active users within the administration.

Parameters

Parameter Type Description
include_accountants 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": "446241836182275291",
    "name": "John Doe",
    "created_at": "2025-02-17T10:49:59.792Z",
    "updated_at": "2025-02-17T10:49:59.801Z",
    "email": "john+3@doe.nl",
    "email_validated": true,
    "language": "nl",
    "time_zone": "Europe/Amsterdam",
    "user_type": "employee",
    "permissions": [
      "time_entries"
    ]
  },
  {
    "id": "446241518578041973",
    "name": "Mo Neybird",
    "created_at": "2025-02-17T10:44:56.902Z",
    "updated_at": "2025-02-17T10:44:57.128Z",
    "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": "446241836300764381",
    "name": "A. Arend.",
    "created_at": "2025-02-17T10:49:59.905Z",
    "updated_at": "2025-02-17T10:50:00.173Z",
    "email": "john+3@doe.nl",
    "email_validated": true,
    "language": "nl",
    "time_zone": "Europe/Amsterdam",
    "user_type": "employee",
    "permissions": [
      "time_entries"
    ]
  },
  {
    "id": "446241518578041973",
    "name": "Mo Neybird",
    "created_at": "2025-02-17T10:44:56.902Z",
    "updated_at": "2025-02-17T10:44:57.128Z",
    "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": "446241836666717458",
    "name": "A. Accountant.",
    "created_at": "2025-02-17T10:50:00.255Z",
    "updated_at": "2025-02-17T10:50:00.260Z",
    "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": "446241518578041973",
    "name": "Mo Neybird",
    "created_at": "2025-02-17T10:44:56.902Z",
    "updated_at": "2025-02-17T10:44:57.128Z",
    "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"
    ]
  }
]