Retrieve Order Status

You can make a call to retrieve an order status any time after the order is placed

Making a request

To retrieve an order status, you will be sending a [GET HTTP call to the /order] (https://accurate.readme.io/reference#getorderbyid-1) resource and appending the URL with the order ID.
https://api.accuratebackground.com/v3/order/

πŸ“˜

All calls require HTTP Basic Authentication

curl --request GET \
  --url https://api.accuratebackground.com/v3/order/id \
  --header 'Accept: application/json' \
  --header 'Authorization: Basic NmQwZWRlMjgtYzNjNS00N2FjLWEwMjctMzg0ZjAyMjVlZDExOjIxMmQ4YTU5LWZhNWYtNGU0My1iM2M4LTk4NGE5ZTUyNDU3Nw=='
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.accuratebackground.com/v3/order/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Accept"] = 'application/json'
request["Authorization"] = 'Basic NmQwZWRlMjgtYzNjNS00N2FjLWEwMjctMzg0ZjAyMjVlZDExOjIxMmQ4YTU5LWZhNWYtNGU0My1iM2M4LTk4NGE5ZTUyNDU3Nw=='

response = http.request(request)
puts response.read_body
const options = {
  method: 'GET',
  headers: {
    Accept: 'application/json',
    Authorization: 'Basic NmQwZWRlMjgtYzNjNS00N2FjLWEwMjctMzg0ZjAyMjVlZDExOjIxMmQ4YTU5LWZhNWYtNGU0My1iM2M4LTk4NGE5ZTUyNDU3Nw=='
  }
};

fetch('https://api.accuratebackground.com/v3/order/id', options)
  .then(response => console.log(response))
  .catch(err => console.error(err));
import requests

url = "https://api.accuratebackground.com/v3/order/id"

headers = {
    "Accept": "application/json",
    "Authorization": "Basic NmQwZWRlMjgtYzNjNS00N2FjLWEwMjctMzg0ZjAyMjVlZDExOjIxMmQ4YTU5LWZhNWYtNGU0My1iM2M4LTk4NGE5ZTUyNDU3Nw=="
}

response = requests.request("GET", url, headers=headers)

print(response.text)
var client = new RestClient("https://api.accuratebackground.com/v3/order/id");
var request = new RestRequest(Method.GET);
request.AddHeader("Accept", "application/json");
request.AddHeader("Authorization", "Basic NmQwZWRlMjgtYzNjNS00N2FjLWEwMjctMzg0ZjAyMjVlZDExOjIxMmQ4YTU5LWZhNWYtNGU0My1iM2M4LTk4NGE5ZTUyNDU3Nw==");
IRestResponse response = client.Execute(request);
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.accuratebackground.com/v3/order/id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Authorization: Basic NmQwZWRlMjgtYzNjNS00N2FjLWEwMjctMzg0ZjAyMjVlZDExOjIxMmQ4YTU5LWZhNWYtNGU0My1iM2M4LTk4NGE5ZTUyNDU3Nw=="
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.accuratebackground.com/v3/order/id")
  .get()
  .addHeader("Accept", "application/json")
  .addHeader("Authorization", "Basic NmQwZWRlMjgtYzNjNS00N2FjLWEwMjctMzg0ZjAyMjVlZDExOjIxMmQ4YTU5LWZhNWYtNGU0My1iM2M4LTk4NGE5ZTUyNDU3Nw==")
  .build();

Response response = client.newCall(request).execute();

Understanding the response

Your response will be the order object and includes many important details including:

  • Status of the order – Overall status of the order. For example, PENDING or COMPLETE
  • Result of the order – Result of the order. Will display as NOT APPLICABLE unless adjudication is enabled for your account in which it will display the adjudication decision.
  • Products – Individual products will be listed within the products array with a unique ID associated with each. With this information, you can choose to display statuses and result down to the product level to your users.

What’s Next

Click here to read the next tutorial for the next step.