Making Requests

Once authenticated, you can begin making calls to the API. Most API calls require a "retailer context" in the endpoint path -- meaning that most calls require you pass a valid retailer_id that belongs to your Account.

To get a list of retailers available for your account, use the following endpoint:

GET https://api.revcascade.com/v1/retailers/
Authorization: Bearer 0oW0r4m1pjIlb5UJujZA5iVuse0XSn

The id(s) that are returned from that request can be passed into other calls wherever you see the {retailer_id} variable in the API endpoint path, such that...

GET https://api.revcascade.com/v1/retailers/{retailer_id}/orders/

becomes...

GET https://api.revcascade.com/v1/retailers/500/orders/
Including Query String Parameters on GET Requests

If you want to pass additional filters into a GET request, please pass query string parameters. For example, if you need to filter a list of orders (note that some filter options, like 'status', can be passed more than once):

GET /v1/retailers/500/orders/?status=open&status=closed&is_acknowledged=true
Authorization: Bearer 0oW0r4m1pjIlb5UJujZA5iVuse0XSn
Including Input in POSTs, PUTs, or PATCHs

To pass in data to POST, PUT, or PATCH endpoints, make sure to attach Content-type: application/json as a header in the request. The input should then be encoded as JSON.

POST /v1/retailers/500/shipments/
Authorization: Bearer 0oW0r4m1pjIlb5UJujZA5iVuse0XSn
Content-type: application/json

powered by