Skip to content
Resource Guru v1 API Documentation
Branch: master
Clone or download
kmckelvin Merge pull request #61 from resourceguru/sso-required-mode-docs
Update with SSO-only mode information
Latest commit f415ae4 Jan 11, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
endpoints Update Jan 2, 2019
sections Update - word wrapping Jan 11, 2019 Added Documentation for Time Off Feb 24, 2016 Update Oct 14, 2015

Resource Guru API

This is a REST-style API that uses serialized JSON and OAuth 2 authentication.

Making Requests


The API expects all data to be UTF-8 encoded.

The Base URL

All requests start with the base URL.

  • All requests are done via SSL.
  • All responses are in JSON.

Making a Basic Request

With the exception of Accounts all requests must be appended with the account subdomain and the path.

To make a request for all the Resources on the Example Corp account, the request URL will look something like this


In order to make authorized calls to Resource Guru's API, your application must first obtain an OAuth access token. To register your app go to

Resource Guru implements OAuth2 with the authentication code flow.

Read our OAuth2 authentication guide to get started.

Once you have authenticated, you can get information about the authenticated user by calling GET More details about the request and response are available on the endpoint page.

Rate Limiting

You can perform up to 33 requests per 10 second period on a registered application. If you exceed this limit, you'll get a 403 Rate Limit Exceeded response for subsequent requests. Check the Retry-After header to see how many seconds to wait before retrying the request.

Response Codes

  • 200 OK
  • 201 Created
  • 204 No Content
  • 401 Unauthorized
  • 403 Forbidden
  • 404 Not Found
  • 422 Unprocessable Entity
  • 5xx Resource Guru is having trouble


You can’t perform that action at this time.