Create a new Rental Case

POST

/customer-api/v1/rental-management/rental-case

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://your-instance.seventhings.com/customer-api/v1/rental-management/rental-case");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{ \"status\": \"requested\", \"title\": \"Rent the printer.\", \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" } ], \"issue_date\": \"2025-04-23\", \"issue_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"due_date\": \"2025-04-23\", \"due_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"responsible_user_uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"renter\": { \"type\": \"plain\", \"value\": \"example\" }, \"comment\": \"The printer is running low on ink.\", \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ] }");

CURLcode ret = curl_easy_perform(hnd);

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://your-instance.seventhings.com/customer-api/v1/rental-management/rental-case"),
    Headers =
    {
        { "Authorization", "Bearer <token>" },
    },
    Content = new StringContent("{ \"status\": \"requested\", \"title\": \"Rent the printer.\", \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" } ], \"issue_date\": \"2025-04-23\", \"issue_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"due_date\": \"2025-04-23\", \"due_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"responsible_user_uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"renter\": { \"type\": \"plain\", \"value\": \"example\" }, \"comment\": \"The printer is running low on ink.\", \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ] }")
    {
        Headers =
        {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

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

func main() {

  url := "https://your-instance.seventhings.com/customer-api/v1/rental-management/rental-case"

  payload := strings.NewReader("{ \"status\": \"requested\", \"title\": \"Rent the printer.\", \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" } ], \"issue_date\": \"2025-04-23\", \"issue_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"due_date\": \"2025-04-23\", \"due_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"responsible_user_uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"renter\": { \"type\": \"plain\", \"value\": \"example\" }, \"comment\": \"The printer is running low on ink.\", \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ] }")

  req, _ := http.NewRequest("POST", url, payload)

  req.Header.Add("Authorization", "Bearer <token>")
  req.Header.Add("Content-Type", "application/json")

  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/rental-management/rental-case"))
    .header("Authorization", "Bearer <token>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{ \"status\": \"requested\", \"title\": \"Rent the printer.\", \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" } ], \"issue_date\": \"2025-04-23\", \"issue_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"due_date\": \"2025-04-23\", \"due_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"responsible_user_uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"renter\": { \"type\": \"plain\", \"value\": \"example\" }, \"comment\": \"The printer is running low on ink.\", \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ] }"))
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{ \"status\": \"requested\", \"title\": \"Rent the printer.\", \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" } ], \"issue_date\": \"2025-04-23\", \"issue_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"due_date\": \"2025-04-23\", \"due_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"responsible_user_uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"renter\": { \"type\": \"plain\", \"value\": \"example\" }, \"comment\": \"The printer is running low on ink.\", \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ] }");
Request request = new Request.Builder()
  .url("https://your-instance.seventhings.com/customer-api/v1/rental-management/rental-case")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build();

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

import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://your-instance.seventhings.com/customer-api/v1/rental-management/rental-case',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  data: {
    status: 'requested',
    title: 'Rent the printer.',
    references: [{type: 'asset', uuid: 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11'}],
    issue_date: '2025-04-23',
    issue_date_reminder: {unit: 'days', value: 2},
    due_date: '2025-04-23',
    due_date_reminder: {unit: 'days', value: 2},
    responsible_user_uuid: 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11',
    renter: {type: 'plain', value: 'example'},
    comment: 'The printer is running low on ink.',
    attachments: ['7d8296ad-da7c-45f7-b676-9220b3a9d4dc']
  }
};

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/rental-management/rental-case';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"status":"requested","title":"Rent the printer.","references":[{"type":"asset","uuid":"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11"}],"issue_date":"2025-04-23","issue_date_reminder":{"unit":"days","value":2},"due_date":"2025-04-23","due_date_reminder":{"unit":"days","value":2},"responsible_user_uuid":"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11","renter":{"type":"plain","value":"example"},"comment":"The printer is running low on ink.","attachments":["7d8296ad-da7c-45f7-b676-9220b3a9d4dc"]}'
};

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

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{ \"status\": \"requested\", \"title\": \"Rent the printer.\", \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" } ], \"issue_date\": \"2025-04-23\", \"issue_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"due_date\": \"2025-04-23\", \"due_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"responsible_user_uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"renter\": { \"type\": \"plain\", \"value\": \"example\" }, \"comment\": \"The printer is running low on ink.\", \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ] }")
val request = Request.Builder()
  .url("https://your-instance.seventhings.com/customer-api/v1/rental-management/rental-case")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .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/rental-management/rental-case",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'status' => 'requested',
    'title' => 'Rent the printer.',
    'references' => [
        [
                'type' => 'asset',
                'uuid' => 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11'
        ]
    ],
    'issue_date' => '2025-04-23',
    'issue_date_reminder' => [
        'unit' => 'days',
        'value' => 2
    ],
    'due_date' => '2025-04-23',
    'due_date_reminder' => [
        'unit' => 'days',
        'value' => 2
    ],
    'responsible_user_uuid' => 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11',
    'renter' => [
        'type' => 'plain',
        'value' => 'example'
    ],
    'comment' => 'The printer is running low on ink.',
    'attachments' => [
        '7d8296ad-da7c-45f7-b676-9220b3a9d4dc'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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('POST', 'https://your-instance.seventhings.com/customer-api/v1/rental-management/rental-case', [
  'body' => '{ "status": "requested", "title": "Rent the printer.", "references": [ { "type": "asset", "uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11" } ], "issue_date": "2025-04-23", "issue_date_reminder": { "unit": "days", "value": 2 }, "due_date": "2025-04-23", "due_date_reminder": { "unit": "days", "value": 2 }, "responsible_user_uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11", "renter": { "type": "plain", "value": "example" }, "comment": "The printer is running low on ink.", "attachments": [ "7d8296ad-da7c-45f7-b676-9220b3a9d4dc" ] }',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();

import http.client

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

payload = "{ \"status\": \"requested\", \"title\": \"Rent the printer.\", \"references\": [ { \"type\": \"asset\", \"uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\" } ], \"issue_date\": \"2025-04-23\", \"issue_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"due_date\": \"2025-04-23\", \"due_date_reminder\": { \"unit\": \"days\", \"value\": 2 }, \"responsible_user_uuid\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\", \"renter\": { \"type\": \"plain\", \"value\": \"example\" }, \"comment\": \"The printer is running low on ink.\", \"attachments\": [ \"7d8296ad-da7c-45f7-b676-9220b3a9d4dc\" ] }"

headers = {
    'Authorization': "Bearer <token>",
    'Content-Type': "application/json"
}

conn.request("POST", "/customer-api/v1/rental-management/rental-case", payload, headers)

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

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

import requests

url = "https://your-instance.seventhings.com/customer-api/v1/rental-management/rental-case"

payload = {
    "status": "requested",
    "title": "Rent the printer.",
    "references": [
        {
            "type": "asset",
            "uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11"
        }
    ],
    "issue_date": "2025-04-23",
    "issue_date_reminder": {
        "unit": "days",
        "value": 2
    },
    "due_date": "2025-04-23",
    "due_date_reminder": {
        "unit": "days",
        "value": 2
    },
    "responsible_user_uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
    "renter": {
        "type": "plain",
        "value": "example"
    },
    "comment": "The printer is running low on ink.",
    "attachments": ["7d8296ad-da7c-45f7-b676-9220b3a9d4dc"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

use serde_json::json;
use reqwest;

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

    let payload = json!({
        "status": "requested",
        "title": "Rent the printer.",
        "references": (
            json!({
                "type": "asset",
                "uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11"
            })
        ),
        "issue_date": "2025-04-23",
        "issue_date_reminder": json!({
            "unit": "days",
            "value": 2
        }),
        "due_date": "2025-04-23",
        "due_date_reminder": json!({
            "unit": "days",
            "value": 2
        }),
        "responsible_user_uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
        "renter": json!({
            "type": "plain",
            "value": "example"
        }),
        "comment": "The printer is running low on ink.",
        "attachments": ("7d8296ad-da7c-45f7-b676-9220b3a9d4dc")
    });

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("Authorization", "Bearer <token>".parse().unwrap());
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = reqwest::Client::new();
    let response = client.post(url)
        .headers(headers)
        .json(&payload)
        .send()
        .await;

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

    dbg!(results);
}

curl --request POST \
  --url https://your-instance.seventhings.com/customer-api/v1/rental-management/rental-case \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "status": "requested", "title": "Rent the printer.", "references": [ { "type": "asset", "uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11" } ], "issue_date": "2025-04-23", "issue_date_reminder": { "unit": "days", "value": 2 }, "due_date": "2025-04-23", "due_date_reminder": { "unit": "days", "value": 2 }, "responsible_user_uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11", "renter": { "type": "plain", "value": "example" }, "comment": "The printer is running low on ink.", "attachments": [ "7d8296ad-da7c-45f7-b676-9220b3a9d4dc" ] }'

wget --quiet \
  --method POST \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --body-data '{ "status": "requested", "title": "Rent the printer.", "references": [ { "type": "asset", "uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11" } ], "issue_date": "2025-04-23", "issue_date_reminder": { "unit": "days", "value": 2 }, "due_date": "2025-04-23", "due_date_reminder": { "unit": "days", "value": 2 }, "responsible_user_uuid": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11", "renter": { "type": "plain", "value": "example" }, "comment": "The printer is running low on ink.", "attachments": [ "7d8296ad-da7c-45f7-b676-9220b3a9d4dc" ] }' \
  --output-document \
  - https://your-instance.seventhings.com/customer-api/v1/rental-management/rental-case

Create a new Rental Case.

Authorizations

bearerAuth

Request Body^required

Rental Case to be created

application/json

The payload for creating a new rental case.

object

status

The status of the rental case.

string

Allowed values: requested confirmed borrowed rejected completed return_overdue pickup_overdue

title

required

The title of the rental case.

string

Example

Rent the printer.

references

required

Array<object>

>= 1 items <= 100 items

The reference of the rental case.

object

type

required

The type of the referenced object.

string

Allowed values: asset

Example

asset

uuid

required

The UUID of the referenced object.

string format: uuid

Example

a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11

name

Display name of the referenced object.

string

Example

Asset name (asset barcode)

The id of the referenced object.

integer

Example

issue_date

required

The start of the rental case.

string format: date

Example

2025-04-23

issue_date_reminder

The amount of time to send a reminder.

object

unit

required

The unit of the time interval.

string

Allowed values: days weeks months years

Example

weeks

value

required

The value of the time interval.

integer

Example

due_date

required

The start of the rental case.

string format: date

Example

2025-04-23

due_date_reminder

object

unit

required

The unit of the time interval.

string

Allowed values: days weeks months years

Example

weeks

value

required

The value of the time interval.

integer

Example

responsible_user_uuid

required

The uuid of the responsible user.

string format: uuid

Example

a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11

renter

The renter.

object

type

required

The type of the renter.

string

Allowed values: plain user

Example

plain

value

required

The value of the renter. In case of a user the uuid is given.

string

comment

A comment that is displayed in the rental case details.

string

nullable

Example

The printer is running low on ink.

attachments

required

Array<string>

Responses

201

Success

Headers

Location

string

Location of the newly created Rental Case

Location-UUID

uuid

The UUID of the newly created object.

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.

500

Internal Server Error.

Create a new Rental Case

Authorizations

Request Bodyrequired

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Responses

201

Headers

400

401

403

500

Request Body^required