Order Status
Order Status
Retrieve a list of Order Statuses
To retrieve a list of Order Statuses from the store, use the code below. Make sure to add your Secure URL, Private Key, and Token as described in Authentication.
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://apirest.3dcart.com/3dCartWebAPI/v2/OrderStatus?limit=&offset=&countonly=");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
  "Content-Type: application/json",
  "Accept: application/json",
  "SecureURL: ",
  "PrivateKey: ",
  "Token: "
));
$response = curl_exec($ch);
curl_close($ch);
var_dump($response);
//Common testing requirement. If you are consuming an API in a sandbox/test region, uncomment this line of code ONLY for non production uses.
//System.Net.ServicePointManager.ServerCertificateValidationCallback = delegate { return true; };
//Be sure to run "Install-Package Microsoft.Net.Http" from your nuget command line.
using System;
using System.Net.Http;
var baseAddress = new Uri("https://apirest.3dcart.com/");
using (var httpClient = new HttpClient{ BaseAddress = baseAddress })
{
  httpClient.DefaultRequestHeaders.TryAddWithoutValidation("accept", "application/json");
  httpClient.DefaultRequestHeaders.TryAddWithoutValidation("secureurl", "");
  httpClient.DefaultRequestHeaders.TryAddWithoutValidation("privatekey", "");
  httpClient.DefaultRequestHeaders.TryAddWithoutValidation("token", "");
  using(var response = await httpClient.GetAsync("3dCartWebAPI/v1/OrderStatus"))
  {
        string responseData = await response.Content.ReadAsStringAsync();
  }
}
var request = new XMLHttpRequest();
request.open('GET', 'https://apirest.3dcart.com/3dCartWebAPI/v2/OrderStatus?limit=&offset=&countonly=');
request.setRequestHeader('Content-Type', 'application/json');
request.setRequestHeader('Accept', 'application/json');
request.setRequestHeader('SecureURL', '');
request.setRequestHeader('PrivateKey', '');
request.setRequestHeader('Token', '');
request.onreadystatechange = function () {
  if (this.readyState === 4) {
    console.log('Status:', this.status);
    console.log('Headers:', this.getAllResponseHeaders());
    console.log('Body:', this.responseText);
  }
};
request.send();
require 'rubygems' if RUBY_VERSION < '1.9'
require 'rest_client'
headers = {
  :content_type => 'application/json',
  :accept => 'application/json',
  :secureurl => '',
  :privatekey => '',
  :token => ''
}
response = RestClient.get 'https://apirest.3dcart.com/3dCartWebAPI/v2/OrderStatus?limit=&offset=&countonly=', headers
puts response
from urllib2 import Request, urlopen
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'SecureURL': '',
  'PrivateKey': '',
  'Token': ''
}
request = Request('https://apirest.3dcart.com/3dCartWebAPI/v2/OrderStatus?limit=&offset=&countonly=', headers=headers)
response_body = urlopen(request).read()
print response_body
The above request will receive a response with JSON structured like this (See Object Definitions for more information on the OrderStatus object):
[
  {
    "OrderStatusID": 1,
    "Sorting": 1,
    "StatusDefinition": "sample string 1",
    "StatusText": "sample string 2",
    "Visible": true
  },
  {
    "OrderStatusID": 1,
    "Sorting": 1,
    "StatusDefinition": "sample string 1",
    "StatusText": "sample string 2",
    "Visible": true
  }
]
This method is used to retrieve a list of Order Statuses from the store. See Object Definitions for more information on the OrderStatus object.
HTTP Request
GET https://apirest.3dcart.com/3dCartWebAPI/v2/OrderStatus
URL Parameters
| Parameter | Required | Description | 
|---|---|---|
| limit | optional | Maximum number of items that can be returned | 
| offset | optional | Starting point for the return data | 
| countonly | optional | Count the number of rows only | 
Responses and Errors
| Response Code | Description | 
|---|---|
| 200 | Successful response code. | 
| 400 | Bad request. Check request headers/parameters/body for errors. | 
| 401 | Authentication failure. The PrivateKey/Token/SecureURL combination is invalid, or the application scope does not have the correct read/write privileges. | 
| 404 | No order statuses found. | 
Retrieve a specific Order Status by id
To retrieve a Cart from the store, use the code below. Make sure to add your Secure URL, Private Key, and Token as described in Authentication.
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://apirest.3dcart.com/3dCartWebAPI/v2/OrderStatus/{id}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
  "Content-Type: application/json",
  "Accept: application/json",
  "SecureURL: ",
  "PrivateKey: ",
  "Token: "
));
$response = curl_exec($ch);
curl_close($ch);
var_dump($response);
//Common testing requirement. If you are consuming an API in a sandbox/test region, uncomment this line of code ONLY for non production uses.
//System.Net.ServicePointManager.ServerCertificateValidationCallback = delegate { return true; };
//Be sure to run "Install-Package Microsoft.Net.Http" from your nuget command line.
using System;
using System.Net.Http;
var baseAddress = new Uri("https://apirest.3dcart.com/");
using (var httpClient = new HttpClient{ BaseAddress = baseAddress })
{
  httpClient.DefaultRequestHeaders.TryAddWithoutValidation("accept", "application/json");
  httpClient.DefaultRequestHeaders.TryAddWithoutValidation("secureurl", "");
  httpClient.DefaultRequestHeaders.TryAddWithoutValidation("privatekey", "");
  httpClient.DefaultRequestHeaders.TryAddWithoutValidation("token", "");
  using(var response = await httpClient.GetAsync("3dCartWebAPI/v1/OrderStatus/{id}"))
  {
        string responseData = await response.Content.ReadAsStringAsync();
  }
}
var request = new XMLHttpRequest();
request.open('GET', 'https://apirest.3dcart.com/3dCartWebAPI/v2/OrderStatus/{id}');
request.setRequestHeader('Content-Type', 'application/json');
request.setRequestHeader('Accept', 'application/json');
request.setRequestHeader('SecureURL', '');
request.setRequestHeader('PrivateKey', '');
request.setRequestHeader('Token', '');
request.onreadystatechange = function () {
  if (this.readyState === 4) {
    console.log('Status:', this.status);
    console.log('Headers:', this.getAllResponseHeaders());
    console.log('Body:', this.responseText);
  }
};
request.send();
require 'rubygems' if RUBY_VERSION < '1.9'
require 'rest_client'
headers = {
  :content_type => 'application/json',
  :accept => 'application/json',
  :secureurl => '',
  :privatekey => '',
  :token => ''
}
response = RestClient.get 'https://apirest.3dcart.com/3dCartWebAPI/v2/OrderStatus/{id}', headers
puts response
from urllib2 import Request, urlopen
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'SecureURL': '',
  'PrivateKey': '',
  'Token': ''
}
request = Request('https://apirest.3dcart.com/3dCartWebAPI/v2/OrderStatus/{id}', headers=headers)
response_body = urlopen(request).read()
print response_body
The above request will receive a response with JSON structured like this (See Object Definitions for more information on the OrderStatus object):
[
  {
    "OrderStatusID": 1,
    "Sorting": 1,
    "StatusDefinition": "sample string 1",
    "StatusText": "sample string 2",
    "Visible": true
  },
  {
    "OrderStatusID": 1,
    "Sorting": 1,
    "StatusDefinition": "sample string 1",
    "StatusText": "sample string 2",
    "Visible": true
  }
]
This method is used to retrieve a specific Order Status from the store. See Object Definitions for more information on the OrderStatus object.
HTTP Request
GET https://apirest.3dcart.com/3dCartWebAPI/v2/OrderStatus{id}
URL Parameters
| Parameter | Required | Description | 
|---|---|---|
| id | required | The unique id of the Order Status | 
Responses and Errors
| Response Code | Description | 
|---|---|
| 200 | Successful response code. | 
| 400 | Bad request. Check request headers/parameters/body for errors. | 
| 401 | Authentication failure. The PrivateKey/Token/SecureURL combination is invalid, or the application scope does not have the correct read/write privileges. | 
| 404 | No order statuses found. |