Quick Start

Step 1: Authenticate and Send Your First Request

All operations with our API must be executed over HTTPS. The API endpoints start with:

https://api.rev.com/

Every API request must be authenticated via the Authorization header, where you paste in your client and user keys. If you don’t have these keys yet, you can get them here.

Rev [Client API Key]:[User API Key]

Now let’s make our first request using the API. All examples in the Quick Start use cURL, a simple command line tool for transferring data. You can access cURL in the following ways:

• On PC, Mac, or Linux: Using Postman to interpret cURL commands- our recommended tool
• On a PC: by downloading cURL
• On a Mac or Linux: via Terminal, where cURL should be installed by default

Run the following GET /orders request; it returns all the orders you’ve placed.

curl -X GET \
    https://api.rev.com/api/v1/orders \
    -H 'Authorization: Rev [ClientApiKey]:[UserAPIKey]'

var https = require('https');

var options = {
  host: 'api.rev.com',
  path: '/api/v1/orders',
  method: 'GET',
  headers: {
    'Authorization': 'Rev [ClientApiKey]:[UserAPIKey]'
  }
};

var req = https.request(options, (resp) => {
  var data = [];

  resp.on('data', (chunk) => {
    data.push(chunk);
  });

  res.on('end', function() {
    console.log('Status Code:', resp.statusCode);
    console.log(JSON.parse(data));
  });
});
req.end();

What you see in response will depend on whether you've placed orders with Rev before.

• If you have placed orders with us, you'll see up to your last 25 orders.
• If you have not placed order before, you should receive the result below. We’ll be placing an order in the next step.

{
   "total_count": 0,
   "results_per_page": 25,
   "page": 0,
   "orders": []
}

Voilá! You have now completed your first API request with the Rev API.

Having trouble? Email apisupport@rev.com and one of our engineers will reply.