Get the history of an object.

GET

/customer-api/v1/object/{objectUuid}/history

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/object/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/history?page=1&per_page=50");

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/object/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/history?page=1&per_page=50"),
    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/object/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/history?page=1&per_page=50"

  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/object/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/history?page=1&per_page=50"))
    .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/object/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/history?page=1&per_page=50")
  .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/object/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/history',
  params: {page: '1', per_page: '50'},
  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/object/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/history?page=1&per_page=50';
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/object/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/history?page=1&per_page=50")
  .get()
  .addHeader("Authorization", "Bearer <token>")
  .build()

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

use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://your-instance.seventhings.com/customer-api/v1/object/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/history";

    let querystring = [
        ("page", "1"),
        ("per_page", "50"),
    ];

    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/object/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/history?page=1&per_page=50' \
  --header 'Authorization: Bearer <token>'

wget --quiet \
  --method GET \
  --header 'Authorization: Bearer <token>' \
  --output-document \
  - 'https://your-instance.seventhings.com/customer-api/v1/object/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/history?page=1&per_page=50'

Get the recorded changes of a single object, newest change first. Objects without any recorded change return an empty page.

Authorizations

bearerAuth

Parameters

Path Parameters

objectUuid

required

string format: uuid

Query Parameters

page

integer format: int32

default: 1 >= 1 <= 1000000

Page number of the results to fetch.

per_page

integer

default: 50 >= 1 <= 200

The number of history entries per page. A single entry can carry a full snapshot of the entity, so this is capped lower than the list endpoints.

Responses

200

Success

application/json

object

items

Array<object>

A single recorded change in the history of an object. The history is assembled from four sources and type says which one an entry comes from: asset for a change of the object itself, task for a task that referenced it, rental_case for a rental case it was part of, and object_merge for another object that was merged into it. The first three carry their payload in properties; an object_merge entry carries user_id and absorbedObjectData instead. Fields the calling role may not see are left out of a change entry.

object

type

The source the entry comes from.

string

Allowed values: asset task rental_case object_merge

date

The date and time of the change, in UTC.

string format: date-time

properties

The payload of the entry. Absent for an entry of type object_merge.

object

key

additional properties

any

key

additional properties

any

page

integer

per_page

integer

total

integer

Example

{
  "items": [
    {
      "type": "asset",
      "date": "2022-04-01T12:00:00+00:00"
    }
  ]
}

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.

406

The requested resource representation has no acceptable format.

500

Internal Server Error.