All API requests should be made to the {{base_url}}/api/v2/ prefix. The base_url can be obtained from the URL of your tenant.

Requests will return responses in JSON format along with standard HTTP success or error status codes. For errors, additional details about what went wrong will be included in the response body. For example:

{
    "detail": "company is required"
}
`https://dashboard.revnue.com`

HTTP Verbs

Revnue utilizes standard CRUD verbs for our web APIs:

MethodDescription
GETRequest used for retrieving a resource
POSTRequest used for creating a resource
PUTRequest used for updating a resource
DELETERequest used for deleting a resource

HTTP Status Codes

The various HTTP status codes we might return are listed below:

CodeTitleDescription
200OKThe request was successful
201CreatedThe resource was successfully created
400Bad RequestBad Request
401UnauthorizedThe API key is invalid or user is not authorized
404Not foundThe resource does not exist
405Method Not AllowedThe HTTP method is not allowed
429Too Many RequestsThe rate limit was exceeded.
50XInternal Server ErrorAn error occurred with our API endpoint