Users

List all users

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": "449763441766302821",
    "name": "Mo Neybird",
    "created_at": "2025-03-28T07:44:24.594Z",
    "updated_at": "2025-03-28T07:44:24.885Z",
    "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": "449763768422893171",
    "name": "John Doe",
    "created_at": "2025-03-28T07:49:36.115Z",
    "updated_at": "2025-03-28T07:49:36.123Z",
    "email": "john+3@doe.nl",
    "email_validated": true,
    "language": "nl",
    "time_zone": "Europe/Amsterdam",
    "user_type": "employee",
    "permissions": [
      "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": "449763441766302821",
    "name": "Mo Neybird",
    "created_at": "2025-03-28T07:44:24.594Z",
    "updated_at": "2025-03-28T07:44:24.885Z",
    "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": "449763768552916597",
    "name": "A. Arend.",
    "created_at": "2025-03-28T07:49:36.239Z",
    "updated_at": "2025-03-28T07:49:36.530Z",
    "email": "john+3@doe.nl",
    "email_validated": true,
    "language": "nl",
    "time_zone": "Europe/Amsterdam",
    "user_type": "employee",
    "permissions": [
      "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": "449763441766302821",
    "name": "Mo Neybird",
    "created_at": "2025-03-28T07:44:24.594Z",
    "updated_at": "2025-03-28T07:44:24.885Z",
    "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": "449763768959764139",
    "name": "A. Accountant.",
    "created_at": "2025-03-28T07:49:36.627Z",
    "updated_at": "2025-03-28T07:49:36.634Z",
    "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"
    ]
  }
]
      

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": "449763441766302821",
    "name": "Mo Neybird",
    "created_at": "2025-03-28T07:44:24.594Z",
    "updated_at": "2025-03-28T07:44:24.885Z",
    "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": "449763769075107501",
    "name": "A. User.",
    "created_at": "2025-03-28T07:49:36.737Z",
    "updated_at": "2025-03-28T07:49:36.755Z"
  }
]