Administration

cURL Ruby

List all administrations

GET /:version/administrations(.:format)

Lists all administrations the current user has access to.

Example: return a list of administrations that user has access to

Request

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

Response

        
          
          Status: 200 OK

[
  {
    "id": "173978910988196842",
    "name": "Administratie",
    "language": "nl",
    "currency": "EUR",
    "country": "NL",
    "time_zone": "Europe/Amsterdam",
    "access": "user",
    "suspended": false,
    "period_locked_until": null
  },
  {
    "id": 123,
    "name": "Parkietje B.V.",
    "language": "nl",
    "currency": "EUR",
    "country": "NL",
    "time_zone": "Europe/Amsterdam",
    "access": "user",
    "suspended": false,
    "period_locked_until": null
  }
]

Example: returns access type user when having direct access to the administration

Request

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

Response

        
          
          Status: 200 OK

[
  {
    "id": "173978911051567236",
    "name": "Parkietje B.V.",
    "language": "nl",
    "currency": "EUR",
    "country": "NL",
    "time_zone": "Europe/Amsterdam",
    "access": "user",
    "suspended": false,
    "period_locked_until": null
  }
]

Example: validates that a user has access to multiple administrations via different ways

Request

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

Response

        
          
          Status: 200 OK

[
  {
    "id": "173978911039185967",
    "name": "Administratie",
    "language": "nl",
    "currency": "EUR",
    "country": "NL",
    "time_zone": "Europe/Amsterdam",
    "access": "accountant_company",
    "suspended": false,
    "period_locked_until": null
  },
  {
    "id": 123,
    "name": "Parkietje B.V.",
    "language": "nl",
    "currency": "EUR",
    "country": "NL",
    "time_zone": "Europe/Amsterdam",
    "access": "user",
    "suspended": false,
    "period_locked_until": null
  }
]