Get all orders from circularity-hub.

GET

/customer-api/v1/circularity-hub/orders

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders?page=1&per_page=50&filter=%7B%22%3Cfilter_id%3E%22%3A%22%3Cfilter_name%3E%22%7D&%3Csort_field%3E=<sort_type>");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders?page=1&per_page=50&filter=%7B%22%3Cfilter_id%3E%22%3A%22%3Cfilter_name%3E%22%7D&%3Csort_field%3E=<sort_type>"),
    Headers =
    {
        { "Authorization", "Bearer <token>" },
    },
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders?page=1&per_page=50&filter=%7B%22%3Cfilter_id%3E%22%3A%22%3Cfilter_name%3E%22%7D&%3Csort_field%3E=<sort_type>"

  req, _ := http.NewRequest("GET", url, nil)

  req.Header.Add("Authorization", "Bearer <token>")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders?page=1&per_page=50&filter=%7B%22%3Cfilter_id%3E%22%3A%22%3Cfilter_name%3E%22%7D&%3Csort_field%3E=<sort_type>"))
    .header("Authorization", "Bearer <token>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders?page=1&per_page=50&filter=%7B%22%3Cfilter_id%3E%22%3A%22%3Cfilter_name%3E%22%7D&%3Csort_field%3E=<sort_type>")
  .get()
  .addHeader("Authorization", "Bearer <token>")
  .build();

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

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders',
  params: {
    page: '1',
    per_page: '50',
    filter: '{"<filter_id>":"<filter_name>"}',
    '<sort_field>': '<sort_type>'
  },
  headers: {Authorization: 'Bearer <token>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders?page=1&per_page=50&filter=%7B%22%3Cfilter_id%3E%22%3A%22%3Cfilter_name%3E%22%7D&%3Csort_field%3E=<sort_type>';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders?page=1&per_page=50&filter=%7B%22%3Cfilter_id%3E%22%3A%22%3Cfilter_name%3E%22%7D&%3Csort_field%3E=<sort_type>")
  .get()
  .addHeader("Authorization", "Bearer <token>")
  .build()

val response = client.newCall(request).execute()

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders?page=1&per_page=50&filter=%7B%22%3Cfilter_id%3E%22%3A%22%3Cfilter_name%3E%22%7D&%3Csort_field%3E=<sort_type>",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders?page=1&per_page=50&filter=%7B%22%3Cfilter_id%3E%22%3A%22%3Cfilter_name%3E%22%7D&%3Csort_field%3E=<sort_type>', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();

import http.client

conn = http.client.HTTPSConnection("your-instance.seventhings.com")

headers = { 'Authorization': "Bearer <token>" }

conn.request("GET", "/customer-api/v1/circularity-hub/orders?page=1&per_page=50&filter=%7B%22%3Cfilter_id%3E%22%3A%22%3Cfilter_name%3E%22%7D&%3Csort_field%3E=<sort_type>", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

import requests

url = "https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders"

querystring = {"page":"1","per_page":"50","filter":"{\"<filter_id>\":\"<filter_name>\"}","<sort_field>":"<sort_type>"}

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())

use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders";

    let querystring = [
        ("page", "1"),
        ("per_page", "50"),
        ("filter", "{"<filter_id>":"<filter_name>"}"),
        ("<sort_field>", "<sort_type>"),
    ];

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("Authorization", "Bearer <token>".parse().unwrap());

    let client = reqwest::Client::new();
    let response = client.get(url)
        .query(&querystring)
        .headers(headers)
        .send()
        .await;

    let results = response.unwrap()
        .json::<serde_json::Value>()
        .await
        .unwrap();

    dbg!(results);
}

curl --request GET \
  --url 'https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders?page=1&per_page=50&filter=%7B%22%3Cfilter_id%3E%22%3A%22%3Cfilter_name%3E%22%7D&%3Csort_field%3E=<sort_type>' \
  --header 'Authorization: Bearer <token>'

wget --quiet \
  --method GET \
  --header 'Authorization: Bearer <token>' \
  --output-document \
  - 'https://your-instance.seventhings.com/customer-api/v1/circularity-hub/orders?page=1&per_page=50&filter=%7B%22%3Cfilter_id%3E%22%3A%22%3Cfilter_name%3E%22%7D&%3Csort_field%3E=<sort_type>'

Get all orders from circularity-hub.

Authorizations

bearerAuth

Parameters

Query Parameters

page

integer format: int32

default: 1 >= 1 <= 1000000

Page number of the results to fetch.

per_page

integer

default: 50 >= 1 <= 1000

The number of results per page.

filter

Fields are defined in Template, so this examples are based on the ~~type~~ of the field, not on the FieldKey

The filter parameter is a deep object, which means that it can have multiple levels of nesting. In the first level there is the field name, in the second level there is the operator and in the third level there are the values or the value. for example: filter[TEXT][eq]='exact searched text'

The exact field name you can find in the field definition list of your customer instance.

The known operators which can be used for one value per field you can find here:

eq which is used for exact match
neq which is used for the opposite of an exact match
gt which is used for a greater than match
gt_or_null which is used for a greater than match or null
gte which is used for a greater than or equal match
gte_or_null which is used for a greater than or equal match or null
lt which is used for a less than match
lt_or_null which is used for a less than match or null
lte which is used for a less than or equal match
lte_or_null which is used for a less than or equal match or null

Here is the list of the known operators which can be used for multiple values per field:

like which is used for a partial match
not_like which is used for a partial mismatch
in which is used for a list of exact matches
nin which is used for a list of the opposite of exact matches

Here are some examples:

filter[TEXT][eq]='exact searched text'
filter[TEXT][neq]='exact searched text'
filter[TEXT][like][]='searched text'
filter[TEXT][not_like][]='searched text'
filter[TEXT][in][]='searched text'
filter[TEXT][nin][]='searched text'
filter[DATE][gt]=2022-11-15
filter[DATE][gt_or_null]=2022-11-15
filter[DATE][gte]=2022-11-15
filter[DATE][gte_or_null]=2022-11-15
filter[DATE][lt]=2022-11-15&filter[DATE][gt]=2022-11-14
filter[DATE][lt_or_null]=2022-11-15&filter[DATE][gt]=2022-11-14
filter[DATE][lte]=2022-11-15&filter[DATE][gt]=2022-11-14
filter[DATE][lte_or_null]=2022-11-15&filter[DATE][gt]=2022-11-14
filter[DATETIME][gt]=2022-11-15+00:00:00
filter[DATETIME][lt]=2022-11-15+00:00:00&filter[DATETIME][gt]=2022-11-14+00:00:00

object

key

additional properties

any

Example

{
  "<filter_id>": "<filter_name>"
}

sort

Fields are defined in Template, so this examples are based on the ~~type~~ of the field, not on the FieldKey

In actual parameter, FieldKey should be passed (e.g: sort[updated_at]=ASC)

Up to columns

Filter options available for certain ~~type~~ of the field:

sort[TEXT]=ASC
sort[DATE]=DESC
sort[TEXT]=DESC&sort[DATE]=ASC

object

key

additional properties

any

Example

{
  "<sort_field>": "<sort_type>"
}

Responses

200

Success

application/json

Array<object>

Inside the mappedAssetData you can find all currently mapped data from the original object If the object was deleted from the system there is a cache with the data from the creation date of the order.

object

key

additional properties

any

Example

[
  {
    "id": 1,
    "order_number": "7THX-24-4570-61",
    "created_at": "2024-05-29 13:02:20",
    "user_id": 1,
    "total_price": 152.56,
    "completed": false,
    "cancelled": true,
    "cancellation_reason": "have to cancel because of problems",
    "billing_data": {
      "firstName": "User",
      "lastName": "Seventhings",
      "street": "Hainstraße",
      "house_number": "2",
      "zip_code": "01097",
      "city": "Dresden"
    },
    "articles": [
      {
        "id": 1,
        "deleted": 0,
        "asset_id": 1,
        "created_at": "2024-05-29 10:53:43",
        "price": 152.56,
        "category_id": 2,
        "suggested_price": 152.56,
        "updated_at": "2024-05-29 10:53:43",
        "mappedAssetData": {
          "item_image": [
            {
              "type": "image/jpeg",
              "name": "Example-Chair.jpg",
              "size": 157814,
              "name_on_server": "assets_600f4403392732.09849361.jpg"
            }
          ],
          "item_title": "Stuhl Meeting",
          "item_description": "Alle Felder können individuell angepasst werden.",
          "item_main_category": "Möbel",
          "item_actual_location": 1,
          "internal_identifier": "DEV0000004",
          "item_original_purchase_date": "2020-11-02",
          "item_original_purchase_price": 279.9,
          "item_manufacturer": "Vitra",
          "documents": null,
          "item_actual_room": 3,
          "item_last_itexia_update_date": "2024-05-28 08:20:29"
        }
      }
    ]
  }
]

400

Request body is missing or invalid or request data is invalid.

401

Access token is missing or invalid.

403

You are not permitted to perform the requested operation.

404

The requested resource could not be found.

406

The requested resource representation has no acceptable format.

422

The requested entry is not processable.

500

Internal Server Error.