API-referens

Alla endpoints i version 1. Hur nycklar, paginering, synk och fel fungerar står i guiden.

Bas-URL: https://api.treadx.se/v1
Autentisering: Authorization: Bearer trx_live_…
Format: JSON, UTF-8
OpenAPI: openapi.json

Kunder

Verkstadens kunder. Används för synk mot ekonomisystem eller CRM.

Lista kunder

GET/v1/customers

Verkstadens kunder i ändringsordning, äldst först. Inaktiva och anonymiserade kunder ingår, så att en synk ser när de ändras.

Behörighet: customers.read

Filter och sidor

limitinteger

Antal poster per sida, 1–200. Standard 50.
cursorstring

nextCursor från föregående sida, oförändrad.
updatedSincetid

Bara poster som skapats eller ändrats från och med den här tiden. ISO 8601 med tidszon, t.ex. 2026-10-01T00:00:00Z.
externalIdstring

Bara posten med ditt eget id.
emailstring

Bara kunden med den här e-postadressen.

Svar

Fälten i svaret

dataarray av objektkrävs

Kunderna på sidan.
Fält i data
- iduuidkrävs
  
  Kundens id i Treadx.
- externalIdstringkrävskan vara null
  
  Ditt eget id för kunden, t.ex. kundnumret i ekonomisystemet. Unikt inom verkstaden.
- firstNamestringkrävs
  
  Förnamn.
- lastNamestringkrävs
  
  Efternamn.
- emailstringkrävskan vara null
  
  E-post. Unik inom verkstaden när den finns.
- phonestringkrävskan vara null
  
  Telefonnummer.
- companystringkrävskan vara null
  
  Företagsnamn.
- addressstringkrävskan vara null
  
  Gatuadress.
- address2stringkrävskan vara null
  
  Adressrad 2.
- postalCodestringkrävskan vara null
  
  Postnummer.
- citystringkrävskan vara null
  
  Ort.
- countrystringkrävskan vara null
  
  Land.
- isActivebooleankrävs
  
  false när kunden tagits bort i Treadx. Efter 30 dagar anonymiseras kunden: namn och kontaktuppgifter töms, id och externalId finns kvar.
- createdAttidkrävs
  
  När kunden skapades.
- updatedAttidkrävs
  
  Senaste ändringen. Samma som createdAt om kunden aldrig ändrats.
nextCursorstringkrävskan vara null

Skicka som cursor för nästa sida. null på sista sidan.

Anrop

curl "https://api.treadx.se/v1/customers" \
  -H "Authorization: Bearer $TREADX_API_KEY"

const response = await fetch("https://api.treadx.se/v1/customers", {
  headers: { Authorization: `Bearer ${process.env.TREADX_API_KEY}` },
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.treadx.se/v1/customers",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var response = await http.GetAsync("/v1/customers");
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 200

{
  "data": [
    {
      "id": "895095f6-3a37-4f73-a37a-c28525a7d12a",
      "externalId": "K-10482",
      "firstName": "Anna",
      "lastName": "Svensson",
      "email": "anna.svensson@example.se",
      "phone": "070-123 45 67",
      "company": "Svenssons Bygg AB",
      "address": "Storgatan 1",
      "address2": "Lgh 1102",
      "postalCode": "791 30",
      "city": "Falun",
      "country": "Sverige",
      "isActive": true,
      "createdAt": "2026-09-14T08:12:44Z",
      "updatedAt": "2026-10-03T14:02:10Z"
    }
  ],
  "nextCursor": "eyJ1IjoiMjAyNi0xMC0wM1QxNDowMjoxMFoifQ"
}

Skapa kund

POST/v1/customers

E-post är frivillig. Anges den måste den vara ledig i verkstaden, liksom externalId. Annars 409.

Behörighet: customers.write

Anrop

firstNamestringkrävs

Förnamn.

Högst 100 tecken
lastNamestringkrävs

Efternamn.

Högst 100 tecken
emailstringkan vara null

E-post. Måste vara ledig i verkstaden.

Högst 256 tecken
phonestringkan vara null

Telefonnummer.

Högst 50 tecken
companystringkan vara null

Företagsnamn.

Högst 200 tecken
addressstringkan vara null

Gatuadress.

Högst 500 tecken
address2stringkan vara null

Adressrad 2.

Högst 500 tecken
postalCodestringkan vara null

Postnummer.

Högst 20 tecken
citystringkan vara null

Ort.

Högst 100 tecken
countrystringkan vara null

Land.

Högst 100 tecken
externalIdstringkan vara null

Ditt eget id för kunden. Måste vara ledigt i verkstaden.

Högst 100 tecken

Svar

201Skapad. `Location` pekar på den nya posten.
400Ogiltig begäran. `errors` anger vilka fält.
409Krock eller fel läge. `errors` anger vilket fält.
401Nyckel saknas eller är ogiltig
403Nyckeln saknar behörighet, eller verkstadens konto är stängt
429För många anrop. Vänta det antal sekunder som `Retry-After` anger.

Fälten i svaret

iduuidkrävs

Kundens id i Treadx.
externalIdstringkrävskan vara null

Ditt eget id för kunden, t.ex. kundnumret i ekonomisystemet. Unikt inom verkstaden.
firstNamestringkrävs

Förnamn.
lastNamestringkrävs

Efternamn.
emailstringkrävskan vara null

E-post. Unik inom verkstaden när den finns.
phonestringkrävskan vara null

Telefonnummer.
companystringkrävskan vara null

Företagsnamn.
addressstringkrävskan vara null

Gatuadress.
address2stringkrävskan vara null

Adressrad 2.
postalCodestringkrävskan vara null

Postnummer.
citystringkrävskan vara null

Ort.
countrystringkrävskan vara null

Land.
isActivebooleankrävs

false när kunden tagits bort i Treadx. Efter 30 dagar anonymiseras kunden: namn och kontaktuppgifter töms, id och externalId finns kvar.
createdAttidkrävs

När kunden skapades.
updatedAttidkrävs

Senaste ändringen. Samma som createdAt om kunden aldrig ändrats.

Anrop

curl -X POST "https://api.treadx.se/v1/customers" \
  -H "Authorization: Bearer $TREADX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "K-10482",
    "firstName": "Anna",
    "lastName": "Svensson",
    "email": "anna.svensson@example.se",
    "phone": "070-123 45 67",
    "address": "Storgatan 1",
    "postalCode": "791 30",
    "city": "Falun"
  }'

const response = await fetch("https://api.treadx.se/v1/customers", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TREADX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    externalId: "K-10482",
    firstName: "Anna",
    lastName: "Svensson",
    email: "anna.svensson@example.se",
    phone: "070-123 45 67",
    address: "Storgatan 1",
    postalCode: "791 30",
    city: "Falun"
  }),
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.treadx.se/v1/customers",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
    json={
        "externalId": "K-10482",
        "firstName": "Anna",
        "lastName": "Svensson",
        "email": "anna.svensson@example.se",
        "phone": "070-123 45 67",
        "address": "Storgatan 1",
        "postalCode": "791 30",
        "city": "Falun"
    },
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;
using System.Text;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var body = """
    {
      "externalId": "K-10482",
      "firstName": "Anna",
      "lastName": "Svensson",
      "email": "anna.svensson@example.se",
      "phone": "070-123 45 67",
      "address": "Storgatan 1",
      "postalCode": "791 30",
      "city": "Falun"
    }
    """;
var response = await http.PostAsync("/v1/customers",
    new StringContent(body, Encoding.UTF8, "application/json"));
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 201

{
  "id": "895095f6-3a37-4f73-a37a-c28525a7d12a",
  "externalId": "K-10482",
  "firstName": "Anna",
  "lastName": "Svensson",
  "email": "anna.svensson@example.se",
  "phone": "070-123 45 67",
  "company": "Svenssons Bygg AB",
  "address": "Storgatan 1",
  "address2": "Lgh 1102",
  "postalCode": "791 30",
  "city": "Falun",
  "country": "Sverige",
  "isActive": true,
  "createdAt": "2026-09-14T08:12:44Z",
  "updatedAt": "2026-10-03T14:02:10Z"
}

Hämta kund

GET/v1/customers/{id}

404 om kunden inte finns eller hör till en annan verkstad.

Behörighet: customers.read

Sökväg

iduuidkrävs

Postens id.

Svar

Fälten i svaret

iduuidkrävs

Kundens id i Treadx.
externalIdstringkrävskan vara null

Ditt eget id för kunden, t.ex. kundnumret i ekonomisystemet. Unikt inom verkstaden.
firstNamestringkrävs

Förnamn.
lastNamestringkrävs

Efternamn.
emailstringkrävskan vara null

E-post. Unik inom verkstaden när den finns.
phonestringkrävskan vara null

Telefonnummer.
companystringkrävskan vara null

Företagsnamn.
addressstringkrävskan vara null

Gatuadress.
address2stringkrävskan vara null

Adressrad 2.
postalCodestringkrävskan vara null

Postnummer.
citystringkrävskan vara null

Ort.
countrystringkrävskan vara null

Land.
isActivebooleankrävs

false när kunden tagits bort i Treadx. Efter 30 dagar anonymiseras kunden: namn och kontaktuppgifter töms, id och externalId finns kvar.
createdAttidkrävs

När kunden skapades.
updatedAttidkrävs

Senaste ändringen. Samma som createdAt om kunden aldrig ändrats.

Anrop

curl "https://api.treadx.se/v1/customers/b80bb774-0288-4da1-b201-890375a60c8f" \
  -H "Authorization: Bearer $TREADX_API_KEY"

const response = await fetch("https://api.treadx.se/v1/customers/b80bb774-0288-4da1-b201-890375a60c8f", {
  headers: { Authorization: `Bearer ${process.env.TREADX_API_KEY}` },
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.treadx.se/v1/customers/b80bb774-0288-4da1-b201-890375a60c8f",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var response = await http.GetAsync("/v1/customers/b80bb774-0288-4da1-b201-890375a60c8f");
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 200

{
  "id": "895095f6-3a37-4f73-a37a-c28525a7d12a",
  "externalId": "K-10482",
  "firstName": "Anna",
  "lastName": "Svensson",
  "email": "anna.svensson@example.se",
  "phone": "070-123 45 67",
  "company": "Svenssons Bygg AB",
  "address": "Storgatan 1",
  "address2": "Lgh 1102",
  "postalCode": "791 30",
  "city": "Falun",
  "country": "Sverige",
  "isActive": true,
  "createdAt": "2026-09-14T08:12:44Z",
  "updatedAt": "2026-10-03T14:02:10Z"
}

Ändra kund

PATCH/v1/customers/{id}

Skicka bara de fält som ska ändras. null tömmer ett fält. firstName och lastName kan inte tömmas. Fält som inte finns i kontraktet ger 400.

Behörighet: customers.write

Sökväg

iduuidkrävs

Postens id.

Anrop

firstNamestring

Förnamn. Kan inte tömmas.

Högst 100 tecken
lastNamestring

Efternamn. Kan inte tömmas.

Högst 100 tecken
emailstringkan vara null

E-post. Måste vara ledig i verkstaden.

Högst 256 tecken
phonestringkan vara null

Telefonnummer.

Högst 50 tecken
companystringkan vara null

Företagsnamn.

Högst 200 tecken
addressstringkan vara null

Gatuadress.

Högst 500 tecken
address2stringkan vara null

Adressrad 2.

Högst 500 tecken
postalCodestringkan vara null

Postnummer.

Högst 20 tecken
citystringkan vara null

Ort.

Högst 100 tecken
countrystringkan vara null

Land.

Högst 100 tecken
externalIdstringkan vara null

Ditt eget id för kunden. Måste vara ledigt i verkstaden.

Högst 100 tecken

Svar

Fälten i svaret

iduuidkrävs

Kundens id i Treadx.
externalIdstringkrävskan vara null

Ditt eget id för kunden, t.ex. kundnumret i ekonomisystemet. Unikt inom verkstaden.
firstNamestringkrävs

Förnamn.
lastNamestringkrävs

Efternamn.
emailstringkrävskan vara null

E-post. Unik inom verkstaden när den finns.
phonestringkrävskan vara null

Telefonnummer.
companystringkrävskan vara null

Företagsnamn.
addressstringkrävskan vara null

Gatuadress.
address2stringkrävskan vara null

Adressrad 2.
postalCodestringkrävskan vara null

Postnummer.
citystringkrävskan vara null

Ort.
countrystringkrävskan vara null

Land.
isActivebooleankrävs

false när kunden tagits bort i Treadx. Efter 30 dagar anonymiseras kunden: namn och kontaktuppgifter töms, id och externalId finns kvar.
createdAttidkrävs

När kunden skapades.
updatedAttidkrävs

Senaste ändringen. Samma som createdAt om kunden aldrig ändrats.

Anrop

curl -X PATCH "https://api.treadx.se/v1/customers/b80bb774-0288-4da1-b201-890375a60c8f" \
  -H "Authorization: Bearer $TREADX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "070-765 43 21",
    "company": null
  }'

const response = await fetch("https://api.treadx.se/v1/customers/b80bb774-0288-4da1-b201-890375a60c8f", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.TREADX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phone: "070-765 43 21",
    company: null
  }),
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.treadx.se/v1/customers/b80bb774-0288-4da1-b201-890375a60c8f",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
    json={
        "phone": "070-765 43 21",
        "company": None
    },
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;
using System.Text;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var body = """
    {
      "phone": "070-765 43 21",
      "company": null
    }
    """;
var response = await http.PatchAsync("/v1/customers/b80bb774-0288-4da1-b201-890375a60c8f",
    new StringContent(body, Encoding.UTF8, "application/json"));
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 200

{
  "id": "895095f6-3a37-4f73-a37a-c28525a7d12a",
  "externalId": "K-10482",
  "firstName": "Anna",
  "lastName": "Svensson",
  "email": "anna.svensson@example.se",
  "phone": "070-123 45 67",
  "company": "Svenssons Bygg AB",
  "address": "Storgatan 1",
  "address2": "Lgh 1102",
  "postalCode": "791 30",
  "city": "Falun",
  "country": "Sverige",
  "isActive": true,
  "createdAt": "2026-09-14T08:12:44Z",
  "updatedAt": "2026-10-03T14:02:10Z"
}

Fordon

Fordon kopplade till kunder.

Lista fordon

GET/v1/vehicles

Verkstadens fordon i ändringsordning, äldst först. Inaktiva fordon och fordon hos anonymiserade kunder ingår.

Behörighet: vehicles.read

Filter och sidor

limitinteger

Antal poster per sida, 1–200. Standard 50.
cursorstring

nextCursor från föregående sida, oförändrad.
updatedSincetid

Bara poster som skapats eller ändrats från och med den här tiden. ISO 8601 med tidszon, t.ex. 2026-10-01T00:00:00Z.
externalIdstring

Bara posten med ditt eget id.
customerIduuid

Bara den här kundens poster.
registrationNumberstring

Bara fordon med det här registreringsnumret. Blanksteg och gemener spelar ingen roll.

Svar

Fälten i svaret

dataarray av objektkrävs

Fordonen på sidan.
Fält i data
- iduuidkrävs
  
  Fordonets id i Treadx.
- externalIdstringkrävskan vara null
  
  Ditt eget id för fordonet. Unikt inom verkstaden.
- customerIduuidkrävs
  
  Kunden som äger fordonet.
- registrationNumberstringkrävs
  
  Registreringsnummer med versaler och utan blanksteg. När kunden anonymiseras blir det ANON-….
- makestringkrävs
  
  Märke.
- modelstringkrävs
  
  Modell.
- yearintegerkrävskan vara null
  
  Årsmodell.
- vinstringkrävskan vara null
  
  Chassinummer.
- isActivebooleankrävs
  
  Om fordonet är aktivt. Styrs från Treadx.
- createdAttidkrävs
  
  När fordonet skapades.
- updatedAttidkrävs
  
  Senaste ändringen.
nextCursorstringkrävskan vara null

Skicka som cursor för nästa sida. null på sista sidan.

Anrop

curl "https://api.treadx.se/v1/vehicles" \
  -H "Authorization: Bearer $TREADX_API_KEY"

const response = await fetch("https://api.treadx.se/v1/vehicles", {
  headers: { Authorization: `Bearer ${process.env.TREADX_API_KEY}` },
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.treadx.se/v1/vehicles",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var response = await http.GetAsync("/v1/vehicles");
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 200

{
  "data": [
    {
      "id": "09d84ec0-1108-4e78-a4e0-dd5011655f3f",
      "externalId": "F-2210",
      "customerId": "59d2dd7f-2490-40c8-902a-2e91f33ac9ce",
      "registrationNumber": "ABC123",
      "make": "Volvo",
      "model": "V60",
      "year": 2019,
      "vin": "YV1ZW72V0K1012345",
      "isActive": true,
      "createdAt": "2026-09-14T08:12:44Z",
      "updatedAt": "2026-10-03T14:02:10Z"
    }
  ],
  "nextCursor": "eyJ1IjoiMjAyNi0xMC0wM1QxNDowMjoxMFoifQ"
}

Skapa fordon

POST/v1/vehicles

Fordonet kopplas till en av verkstadens kunder. Registreringsnumret sparas med versaler och utan blanksteg. 409 om externalId redan används.

Behörighet: vehicles.write

Anrop

customerIduuidkrävs

En av verkstadens kunder. Annars 400.
registrationNumberstringkrävs

Registreringsnummer. Sparas med versaler och utan blanksteg.

Högst 20 tecken
makestringkrävs

Märke.

Högst 100 tecken
modelstringkrävs

Modell.

Högst 100 tecken
yearintegerkan vara null

Årsmodell.

1900–2100
vinstringkan vara null

Chassinummer.

Högst 30 tecken
externalIdstringkan vara null

Ditt eget id för fordonet. Måste vara ledigt i verkstaden.

Högst 100 tecken

Svar

201Skapad. `Location` pekar på den nya posten.
400Ogiltig begäran. `errors` anger vilka fält.
409Krock eller fel läge. `errors` anger vilket fält.
401Nyckel saknas eller är ogiltig
403Nyckeln saknar behörighet, eller verkstadens konto är stängt
429För många anrop. Vänta det antal sekunder som `Retry-After` anger.

Fälten i svaret

iduuidkrävs

Fordonets id i Treadx.
externalIdstringkrävskan vara null

Ditt eget id för fordonet. Unikt inom verkstaden.
customerIduuidkrävs

Kunden som äger fordonet.
registrationNumberstringkrävs

Registreringsnummer med versaler och utan blanksteg. När kunden anonymiseras blir det ANON-….
makestringkrävs

Märke.
modelstringkrävs

Modell.
yearintegerkrävskan vara null

Årsmodell.
vinstringkrävskan vara null

Chassinummer.
isActivebooleankrävs

Om fordonet är aktivt. Styrs från Treadx.
createdAttidkrävs

När fordonet skapades.
updatedAttidkrävs

Senaste ändringen.

Anrop

curl -X POST "https://api.treadx.se/v1/vehicles" \
  -H "Authorization: Bearer $TREADX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "0d5c3e2a-8f41-4b7e-9a63-2c1f0e7d4b58",
    "registrationNumber": "ABC123",
    "make": "Volvo",
    "model": "V60",
    "year": 2019
  }'

const response = await fetch("https://api.treadx.se/v1/vehicles", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TREADX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    customerId: "0d5c3e2a-8f41-4b7e-9a63-2c1f0e7d4b58",
    registrationNumber: "ABC123",
    make: "Volvo",
    model: "V60",
    year: 2019
  }),
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.treadx.se/v1/vehicles",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
    json={
        "customerId": "0d5c3e2a-8f41-4b7e-9a63-2c1f0e7d4b58",
        "registrationNumber": "ABC123",
        "make": "Volvo",
        "model": "V60",
        "year": 2019
    },
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;
using System.Text;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var body = """
    {
      "customerId": "0d5c3e2a-8f41-4b7e-9a63-2c1f0e7d4b58",
      "registrationNumber": "ABC123",
      "make": "Volvo",
      "model": "V60",
      "year": 2019
    }
    """;
var response = await http.PostAsync("/v1/vehicles",
    new StringContent(body, Encoding.UTF8, "application/json"));
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 201

{
  "id": "09d84ec0-1108-4e78-a4e0-dd5011655f3f",
  "externalId": "F-2210",
  "customerId": "59d2dd7f-2490-40c8-902a-2e91f33ac9ce",
  "registrationNumber": "ABC123",
  "make": "Volvo",
  "model": "V60",
  "year": 2019,
  "vin": "YV1ZW72V0K1012345",
  "isActive": true,
  "createdAt": "2026-09-14T08:12:44Z",
  "updatedAt": "2026-10-03T14:02:10Z"
}

Hämta fordon

GET/v1/vehicles/{id}

404 om fordonet inte finns eller hör till en annan verkstad.

Behörighet: vehicles.read

Sökväg

iduuidkrävs

Postens id.

Svar

Fälten i svaret

iduuidkrävs

Fordonets id i Treadx.
externalIdstringkrävskan vara null

Ditt eget id för fordonet. Unikt inom verkstaden.
customerIduuidkrävs

Kunden som äger fordonet.
registrationNumberstringkrävs

Registreringsnummer med versaler och utan blanksteg. När kunden anonymiseras blir det ANON-….
makestringkrävs

Märke.
modelstringkrävs

Modell.
yearintegerkrävskan vara null

Årsmodell.
vinstringkrävskan vara null

Chassinummer.
isActivebooleankrävs

Om fordonet är aktivt. Styrs från Treadx.
createdAttidkrävs

När fordonet skapades.
updatedAttidkrävs

Senaste ändringen.

Anrop

curl "https://api.treadx.se/v1/vehicles/b80bb774-0288-4da1-b201-890375a60c8f" \
  -H "Authorization: Bearer $TREADX_API_KEY"

const response = await fetch("https://api.treadx.se/v1/vehicles/b80bb774-0288-4da1-b201-890375a60c8f", {
  headers: { Authorization: `Bearer ${process.env.TREADX_API_KEY}` },
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.treadx.se/v1/vehicles/b80bb774-0288-4da1-b201-890375a60c8f",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var response = await http.GetAsync("/v1/vehicles/b80bb774-0288-4da1-b201-890375a60c8f");
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 200

{
  "id": "09d84ec0-1108-4e78-a4e0-dd5011655f3f",
  "externalId": "F-2210",
  "customerId": "59d2dd7f-2490-40c8-902a-2e91f33ac9ce",
  "registrationNumber": "ABC123",
  "make": "Volvo",
  "model": "V60",
  "year": 2019,
  "vin": "YV1ZW72V0K1012345",
  "isActive": true,
  "createdAt": "2026-09-14T08:12:44Z",
  "updatedAt": "2026-10-03T14:02:10Z"
}

Ändra fordon

PATCH/v1/vehicles/{id}

Skicka bara de fält som ska ändras. null tömmer ett fält. Med customerId flyttas fordonet till en annan kund. Om fordonet är aktivt styrs från Treadx och kan inte ändras här.

Behörighet: vehicles.write

Sökväg

iduuidkrävs

Postens id.

Anrop

customerIduuid

Flyttar fordonet till en annan av verkstadens kunder.
registrationNumberstring

Registreringsnummer. Kan inte tömmas.

Högst 20 tecken
makestring

Märke. Kan inte tömmas.

Högst 100 tecken
modelstring

Modell. Kan inte tömmas.

Högst 100 tecken
yearintegerkan vara null

Årsmodell.

1900–2100
vinstringkan vara null

Chassinummer.

Högst 30 tecken
externalIdstringkan vara null

Ditt eget id för fordonet. Måste vara ledigt i verkstaden.

Högst 100 tecken

Svar

Fälten i svaret

iduuidkrävs

Fordonets id i Treadx.
externalIdstringkrävskan vara null

Ditt eget id för fordonet. Unikt inom verkstaden.
customerIduuidkrävs

Kunden som äger fordonet.
registrationNumberstringkrävs

Registreringsnummer med versaler och utan blanksteg. När kunden anonymiseras blir det ANON-….
makestringkrävs

Märke.
modelstringkrävs

Modell.
yearintegerkrävskan vara null

Årsmodell.
vinstringkrävskan vara null

Chassinummer.
isActivebooleankrävs

Om fordonet är aktivt. Styrs från Treadx.
createdAttidkrävs

När fordonet skapades.
updatedAttidkrävs

Senaste ändringen.

Anrop

curl -X PATCH "https://api.treadx.se/v1/vehicles/b80bb774-0288-4da1-b201-890375a60c8f" \
  -H "Authorization: Bearer $TREADX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "registrationNumber": "XYZ789",
    "vin": null
  }'

const response = await fetch("https://api.treadx.se/v1/vehicles/b80bb774-0288-4da1-b201-890375a60c8f", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.TREADX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    registrationNumber: "XYZ789",
    vin: null
  }),
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.treadx.se/v1/vehicles/b80bb774-0288-4da1-b201-890375a60c8f",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
    json={
        "registrationNumber": "XYZ789",
        "vin": None
    },
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;
using System.Text;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var body = """
    {
      "registrationNumber": "XYZ789",
      "vin": null
    }
    """;
var response = await http.PatchAsync("/v1/vehicles/b80bb774-0288-4da1-b201-890375a60c8f",
    new StringContent(body, Encoding.UTF8, "application/json"));
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 200

{
  "id": "09d84ec0-1108-4e78-a4e0-dd5011655f3f",
  "externalId": "F-2210",
  "customerId": "59d2dd7f-2490-40c8-902a-2e91f33ac9ce",
  "registrationNumber": "ABC123",
  "make": "Volvo",
  "model": "V60",
  "year": 2019,
  "vin": "YV1ZW72V0K1012345",
  "isActive": true,
  "createdAt": "2026-09-14T08:12:44Z",
  "updatedAt": "2026-10-03T14:02:10Z"
}

Hjuluppsättningar

Hjuluppsättningar med däck, mönsterdjup och lagerplats, och hjulskifte.

Lista hjuluppsättningar

GET/v1/wheelsets

Hjuluppsättningar i ändringsordning, äldst först. Avslutade uppsättningar ingår. updatedAt ändras också när ett hjul eller lagerplatsen ändras, så ett nytt mönsterdjup kommer med i synken.

Behörighet: wheelsets.read

Filter och sidor

limitinteger

Antal poster per sida, 1–200. Standard 50.
cursorstring

nextCursor från föregående sida, oförändrad.
updatedSincetid

Bara poster som skapats eller ändrats från och med den här tiden. ISO 8601 med tidszon, t.ex. 2026-10-01T00:00:00Z.
vehicleIduuid

Bara det här fordonets uppsättningar.
customerIduuid

Bara den här kundens poster.
seasonstring

Bara uppsättningar för säsongen: Summer, WinterStudded eller WinterNonStudded.
externalIdstring

Bara posten med ditt eget id.

Svar

Fälten i svaret

dataarray av objektkrävs

Uppsättningarna på sidan.
Fält i data
- iduuidkrävs
  
  Uppsättningens id i Treadx.
- externalIdstringkrävskan vara null
  
  Ditt eget id för uppsättningen, t.ex. numret i ett tidigare system. Unikt inom verkstaden.
- vehicleIduuidkrävs
  
  Fordonet uppsättningen hör till.
- seasonstringkrävs
  
  Säsong.
  
  Värden: Summer WinterStudded WinterNonStudded
- statusstringkrävs
  
  InStorage i lager, Mounted på bilen, ReturnedToCustomer utlämnad.
  
  Värden: Unknown Mounted InStorage ReturnedToCustomer
- isActivebooleankrävs
  
  false när uppsättningen är avslutad i däckhotellet.
- storageLocationobjektkrävskan vara null
  
  Lagerplatsen uppsättningen har tilldelats. Den ligger kvar medan uppsättningen är monterad, så hjulen står där bara när status är InStorage. null när ingen plats är tilldelad.
  Fält i storageLocation
  - iduuidkrävs
    
    Lagerplatsens id.
  - namestringkrävs
    
    Lagerplatsens namn.
- checkedOutAttidkrävskan vara null
  
  När uppsättningen avslutades. null så länge den är aktiv.
- wheelsarray av objektkrävs
  
  Hjulen, ett per position.
  Fält i wheels
  - iduuidkrävs
    
    Hjulets id.
  - positionstringkrävs
    
    Position på bilen.
    
    Värden: FrontRight FrontLeft RearRight RearLeft
  - rimTypestringkrävskan vara null
    
    Fälgtyp.
    
    Värden: AluminiumOriginal AluminiumAccessory SteelRim
  - tyreBrandstringkrävskan vara null
    
    Däckmärke.
  - tyreModelstringkrävskan vara null
    
    Däckmodell.
  - tyreWidthintegerkrävskan vara null
    
    Däckbredd i mm.
  - tyreProfileintegerkrävskan vara null
    
    Profil, höjden i procent av bredden.
  - tyreConstructionstringkrävskan vara null
    
    Konstruktion, t.ex. R.
  - rimDiameterintegerkrävskan vara null
    
    Fälgdiameter i tum.
  - loadIndexintegerkrävskan vara null
    
    Belastningsindex.
  - speedIndexstringkrävskan vara null
    
    Hastighetsindex.
  - treadDepthMmnumberkrävskan vara null
    
    Mönsterdjup i mm, en decimal.
- createdAttidkrävs
  
  När uppsättningen registrerades.
- updatedAttidkrävs
  
  Senaste ändringen av uppsättningen, något hjul eller lagerplatsen.
nextCursorstringkrävskan vara null

Skicka som cursor för nästa sida. null på sista sidan.

Anrop

curl "https://api.treadx.se/v1/wheelsets" \
  -H "Authorization: Bearer $TREADX_API_KEY"

const response = await fetch("https://api.treadx.se/v1/wheelsets", {
  headers: { Authorization: `Bearer ${process.env.TREADX_API_KEY}` },
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.treadx.se/v1/wheelsets",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var response = await http.GetAsync("/v1/wheelsets");
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 200

{
  "data": [
    {
      "id": "a451c889-b755-46ee-b9b4-8bb4e46ebf9e",
      "externalId": "DH-2041",
      "vehicleId": "1b0eb45d-0770-49e7-87d6-b47f0203c86a",
      "season": "WinterStudded",
      "status": "InStorage",
      "isActive": true,
      "storageLocation": {
        "id": "922615d4-816c-4552-a845-9e435f1bb15e",
        "name": "B2-H4"
      },
      "checkedOutAt": null,
      "wheels": [
        {
          "id": "5b26b063-78e3-422b-a24c-64894b84d9e5",
          "position": "FrontRight",
          "rimType": null,
          "tyreBrand": "Nokian",
          "tyreModel": "Hakkapeliitta 10",
          "tyreWidth": 205,
          "tyreProfile": 55,
          "tyreConstruction": "R",
          "rimDiameter": 16,
          "loadIndex": 94,
          "speedIndex": "T",
          "treadDepthMm": 7.8
        }
      ],
      "createdAt": "2026-09-14T08:12:44Z",
      "updatedAt": "2026-10-03T14:02:10Z"
    }
  ],
  "nextCursor": "eyJ1IjoiMjAyNi0xMC0wM1QxNDowMjoxMFoifQ"
}

Registrerar en uppsättning på ett av verkstadens fordon. InStorage läggs i lager och kräver en lagerplats med ledigt. Mounted sitter på bilen, högst en per fordon, och får sin plats vid hjulskiftet.

Alla fyra hjul skickas, varje position en gång. Fordonets andra uppsättningar ändras aldrig. 409 när platsen är full, fordonet redan har en monterad uppsättning eller externalId används.

Behörighet: wheelsets.write

Anrop

vehicleIduuidkrävs

Ett av verkstadens aktiva fordon.
seasonstringkrävs

Säsong.

Värden: Summer WinterStudded WinterNonStudded
statusstringkrävs

InStorage för en uppsättning i lager, Mounted för den som sitter på bilen.

Värden: InStorage Mounted
storageLocationIduuidkan vara null

Krävs för InStorage. Platsen måste ha ledigt. Utelämnas för Mounted.
packageIduuidkan vara null

Däckhotellpaket.
externalIdstringkan vara null

Ditt eget id för uppsättningen. Måste vara ledigt i verkstaden.

Högst 100 tecken
wheelsarray av objektkrävs

Alla fyra hjul, varje position en gång.

Exakt 4 st
Fält i wheels
- positionstringkrävs
  
  Position på bilen.
  
  Värden: FrontRight FrontLeft RearRight RearLeft
- rimTypestringkan vara null
  
  Fälgtyp.
  
  Värden: AluminiumOriginal AluminiumAccessory SteelRim
- tyreBrandstringkan vara null
  
  Däckmärke.
  
  Högst 100 tecken
- tyreModelstringkan vara null
  
  Däckmodell.
  
  Högst 100 tecken
- tyreWidthintegerkan vara null
  
  Däckbredd i mm.
- tyreProfileintegerkan vara null
  
  Profil, höjden i procent av bredden.
- tyreConstructionstringkan vara null
  
  Konstruktion, t.ex. R.
  
  Högst 5 tecken
- rimDiameterintegerkan vara null
  
  Fälgdiameter i tum.
- loadIndexintegerkan vara null
  
  Belastningsindex.
- speedIndexstringkan vara null
  
  Hastighetsindex.
  
  Högst 5 tecken
- treadDepthMmnumberkan vara null
  
  Mönsterdjup i mm.
  
  0–30

Svar

201Skapad. `Location` pekar på den nya posten.
400Ogiltig begäran. `errors` anger vilka fält.
409Krock eller fel läge. `errors` anger vilket fält.
401Nyckel saknas eller är ogiltig
403Nyckeln saknar behörighet, eller verkstadens konto är stängt
429För många anrop. Vänta det antal sekunder som `Retry-After` anger.

Fälten i svaret

iduuidkrävs

Uppsättningens id i Treadx.
externalIdstringkrävskan vara null

Ditt eget id för uppsättningen, t.ex. numret i ett tidigare system. Unikt inom verkstaden.
vehicleIduuidkrävs

Fordonet uppsättningen hör till.
seasonstringkrävs

Säsong.

Värden: Summer WinterStudded WinterNonStudded
statusstringkrävs

InStorage i lager, Mounted på bilen, ReturnedToCustomer utlämnad.

Värden: Unknown Mounted InStorage ReturnedToCustomer
isActivebooleankrävs

false när uppsättningen är avslutad i däckhotellet.
storageLocationobjektkrävskan vara null

Lagerplatsen uppsättningen har tilldelats. Den ligger kvar medan uppsättningen är monterad, så hjulen står där bara när status är InStorage. null när ingen plats är tilldelad.
Fält i storageLocation
- iduuidkrävs
  
  Lagerplatsens id.
- namestringkrävs
  
  Lagerplatsens namn.
checkedOutAttidkrävskan vara null

När uppsättningen avslutades. null så länge den är aktiv.
wheelsarray av objektkrävs

Hjulen, ett per position.
Fält i wheels
- iduuidkrävs
  
  Hjulets id.
- positionstringkrävs
  
  Position på bilen.
  
  Värden: FrontRight FrontLeft RearRight RearLeft
- rimTypestringkrävskan vara null
  
  Fälgtyp.
  
  Värden: AluminiumOriginal AluminiumAccessory SteelRim
- tyreBrandstringkrävskan vara null
  
  Däckmärke.
- tyreModelstringkrävskan vara null
  
  Däckmodell.
- tyreWidthintegerkrävskan vara null
  
  Däckbredd i mm.
- tyreProfileintegerkrävskan vara null
  
  Profil, höjden i procent av bredden.
- tyreConstructionstringkrävskan vara null
  
  Konstruktion, t.ex. R.
- rimDiameterintegerkrävskan vara null
  
  Fälgdiameter i tum.
- loadIndexintegerkrävskan vara null
  
  Belastningsindex.
- speedIndexstringkrävskan vara null
  
  Hastighetsindex.
- treadDepthMmnumberkrävskan vara null
  
  Mönsterdjup i mm, en decimal.
createdAttidkrävs

När uppsättningen registrerades.
updatedAttidkrävs

Senaste ändringen av uppsättningen, något hjul eller lagerplatsen.

Anrop

curl -X POST "https://api.treadx.se/v1/wheelsets" \
  -H "Authorization: Bearer $TREADX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "DH-2041",
    "vehicleId": "7b2e4f19-3c8a-4d6e-b015-9e4a2c7f1d63",
    "season": "WinterStudded",
    "status": "InStorage",
    "storageLocationId": "4e8a1c27-6b3f-4f9d-8a52-1d7c9e3b0f46",
    "wheels": [
      {
        "position": "FrontLeft",
        "tyreBrand": "Nokian",
        "tyreModel": "Hakkapeliitta 10",
        "tyreWidth": 205,
        "tyreProfile": 55,
        "rimDiameter": 16,
        "treadDepthMm": 7.8
      },
      {
        "position": "FrontRight",
        "tyreBrand": "Nokian",
        "tyreModel": "Hakkapeliitta 10",
        "tyreWidth": 205,
        "tyreProfile": 55,
        "rimDiameter": 16,
        "treadDepthMm": 7.9
      },
      {
        "position": "RearLeft",
        "tyreBrand": "Nokian",
        "tyreModel": "Hakkapeliitta 10",
        "tyreWidth": 205,
        "tyreProfile": 55,
        "rimDiameter": 16,
        "treadDepthMm": 8.2
      },
      {
        "position": "RearRight",
        "tyreBrand": "Nokian",
        "tyreModel": "Hakkapeliitta 10",
        "tyreWidth": 205,
        "tyreProfile": 55,
        "rimDiameter": 16,
        "treadDepthMm": 8.1
      }
    ]
  }'

const response = await fetch("https://api.treadx.se/v1/wheelsets", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TREADX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    externalId: "DH-2041",
    vehicleId: "7b2e4f19-3c8a-4d6e-b015-9e4a2c7f1d63",
    season: "WinterStudded",
    status: "InStorage",
    storageLocationId: "4e8a1c27-6b3f-4f9d-8a52-1d7c9e3b0f46",
    wheels: [
      {
        position: "FrontLeft",
        tyreBrand: "Nokian",
        tyreModel: "Hakkapeliitta 10",
        tyreWidth: 205,
        tyreProfile: 55,
        rimDiameter: 16,
        treadDepthMm: 7.8
      },
      {
        position: "FrontRight",
        tyreBrand: "Nokian",
        tyreModel: "Hakkapeliitta 10",
        tyreWidth: 205,
        tyreProfile: 55,
        rimDiameter: 16,
        treadDepthMm: 7.9
      },
      {
        position: "RearLeft",
        tyreBrand: "Nokian",
        tyreModel: "Hakkapeliitta 10",
        tyreWidth: 205,
        tyreProfile: 55,
        rimDiameter: 16,
        treadDepthMm: 8.2
      },
      {
        position: "RearRight",
        tyreBrand: "Nokian",
        tyreModel: "Hakkapeliitta 10",
        tyreWidth: 205,
        tyreProfile: 55,
        rimDiameter: 16,
        treadDepthMm: 8.1
      }
    ]
  }),
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.treadx.se/v1/wheelsets",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
    json={
        "externalId": "DH-2041",
        "vehicleId": "7b2e4f19-3c8a-4d6e-b015-9e4a2c7f1d63",
        "season": "WinterStudded",
        "status": "InStorage",
        "storageLocationId": "4e8a1c27-6b3f-4f9d-8a52-1d7c9e3b0f46",
        "wheels": [
            {
                "position": "FrontLeft",
                "tyreBrand": "Nokian",
                "tyreModel": "Hakkapeliitta 10",
                "tyreWidth": 205,
                "tyreProfile": 55,
                "rimDiameter": 16,
                "treadDepthMm": 7.8
            },
            {
                "position": "FrontRight",
                "tyreBrand": "Nokian",
                "tyreModel": "Hakkapeliitta 10",
                "tyreWidth": 205,
                "tyreProfile": 55,
                "rimDiameter": 16,
                "treadDepthMm": 7.9
            },
            {
                "position": "RearLeft",
                "tyreBrand": "Nokian",
                "tyreModel": "Hakkapeliitta 10",
                "tyreWidth": 205,
                "tyreProfile": 55,
                "rimDiameter": 16,
                "treadDepthMm": 8.2
            },
            {
                "position": "RearRight",
                "tyreBrand": "Nokian",
                "tyreModel": "Hakkapeliitta 10",
                "tyreWidth": 205,
                "tyreProfile": 55,
                "rimDiameter": 16,
                "treadDepthMm": 8.1
            }
        ]
    },
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;
using System.Text;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var body = """
    {
      "externalId": "DH-2041",
      "vehicleId": "7b2e4f19-3c8a-4d6e-b015-9e4a2c7f1d63",
      "season": "WinterStudded",
      "status": "InStorage",
      "storageLocationId": "4e8a1c27-6b3f-4f9d-8a52-1d7c9e3b0f46",
      "wheels": [
        {
          "position": "FrontLeft",
          "tyreBrand": "Nokian",
          "tyreModel": "Hakkapeliitta 10",
          "tyreWidth": 205,
          "tyreProfile": 55,
          "rimDiameter": 16,
          "treadDepthMm": 7.8
        },
        {
          "position": "FrontRight",
          "tyreBrand": "Nokian",
          "tyreModel": "Hakkapeliitta 10",
          "tyreWidth": 205,
          "tyreProfile": 55,
          "rimDiameter": 16,
          "treadDepthMm": 7.9
        },
        {
          "position": "RearLeft",
          "tyreBrand": "Nokian",
          "tyreModel": "Hakkapeliitta 10",
          "tyreWidth": 205,
          "tyreProfile": 55,
          "rimDiameter": 16,
          "treadDepthMm": 8.2
        },
        {
          "position": "RearRight",
          "tyreBrand": "Nokian",
          "tyreModel": "Hakkapeliitta 10",
          "tyreWidth": 205,
          "tyreProfile": 55,
          "rimDiameter": 16,
          "treadDepthMm": 8.1
        }
      ]
    }
    """;
var response = await http.PostAsync("/v1/wheelsets",
    new StringContent(body, Encoding.UTF8, "application/json"));
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 201

{
  "id": "a451c889-b755-46ee-b9b4-8bb4e46ebf9e",
  "externalId": "DH-2041",
  "vehicleId": "1b0eb45d-0770-49e7-87d6-b47f0203c86a",
  "season": "WinterStudded",
  "status": "InStorage",
  "isActive": true,
  "storageLocation": {
    "id": "922615d4-816c-4552-a845-9e435f1bb15e",
    "name": "B2-H4"
  },
  "checkedOutAt": null,
  "wheels": [
    {
      "id": "5b26b063-78e3-422b-a24c-64894b84d9e5",
      "position": "FrontRight",
      "rimType": null,
      "tyreBrand": "Nokian",
      "tyreModel": "Hakkapeliitta 10",
      "tyreWidth": 205,
      "tyreProfile": 55,
      "tyreConstruction": "R",
      "rimDiameter": 16,
      "loadIndex": 94,
      "speedIndex": "T",
      "treadDepthMm": 7.8
    }
  ],
  "createdAt": "2026-09-14T08:12:44Z",
  "updatedAt": "2026-10-03T14:02:10Z"
}

Hämta hjuluppsättning

GET/v1/wheelsets/{id}

En uppsättning med hjul och lagerplats. 404 om den inte finns eller hör till en annan verkstad.

Behörighet: wheelsets.read

Sökväg

iduuidkrävs

Postens id.

Svar

Fälten i svaret

iduuidkrävs

Uppsättningens id i Treadx.
externalIdstringkrävskan vara null

Ditt eget id för uppsättningen, t.ex. numret i ett tidigare system. Unikt inom verkstaden.
vehicleIduuidkrävs

Fordonet uppsättningen hör till.
seasonstringkrävs

Säsong.

Värden: Summer WinterStudded WinterNonStudded
statusstringkrävs

InStorage i lager, Mounted på bilen, ReturnedToCustomer utlämnad.

Värden: Unknown Mounted InStorage ReturnedToCustomer
isActivebooleankrävs

false när uppsättningen är avslutad i däckhotellet.
storageLocationobjektkrävskan vara null

Lagerplatsen uppsättningen har tilldelats. Den ligger kvar medan uppsättningen är monterad, så hjulen står där bara när status är InStorage. null när ingen plats är tilldelad.
Fält i storageLocation
- iduuidkrävs
  
  Lagerplatsens id.
- namestringkrävs
  
  Lagerplatsens namn.
checkedOutAttidkrävskan vara null

När uppsättningen avslutades. null så länge den är aktiv.
wheelsarray av objektkrävs

Hjulen, ett per position.
Fält i wheels
- iduuidkrävs
  
  Hjulets id.
- positionstringkrävs
  
  Position på bilen.
  
  Värden: FrontRight FrontLeft RearRight RearLeft
- rimTypestringkrävskan vara null
  
  Fälgtyp.
  
  Värden: AluminiumOriginal AluminiumAccessory SteelRim
- tyreBrandstringkrävskan vara null
  
  Däckmärke.
- tyreModelstringkrävskan vara null
  
  Däckmodell.
- tyreWidthintegerkrävskan vara null
  
  Däckbredd i mm.
- tyreProfileintegerkrävskan vara null
  
  Profil, höjden i procent av bredden.
- tyreConstructionstringkrävskan vara null
  
  Konstruktion, t.ex. R.
- rimDiameterintegerkrävskan vara null
  
  Fälgdiameter i tum.
- loadIndexintegerkrävskan vara null
  
  Belastningsindex.
- speedIndexstringkrävskan vara null
  
  Hastighetsindex.
- treadDepthMmnumberkrävskan vara null
  
  Mönsterdjup i mm, en decimal.
createdAttidkrävs

När uppsättningen registrerades.
updatedAttidkrävs

Senaste ändringen av uppsättningen, något hjul eller lagerplatsen.

Anrop

curl "https://api.treadx.se/v1/wheelsets/b80bb774-0288-4da1-b201-890375a60c8f" \
  -H "Authorization: Bearer $TREADX_API_KEY"

const response = await fetch("https://api.treadx.se/v1/wheelsets/b80bb774-0288-4da1-b201-890375a60c8f", {
  headers: { Authorization: `Bearer ${process.env.TREADX_API_KEY}` },
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.treadx.se/v1/wheelsets/b80bb774-0288-4da1-b201-890375a60c8f",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var response = await http.GetAsync("/v1/wheelsets/b80bb774-0288-4da1-b201-890375a60c8f");
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 200

{
  "id": "a451c889-b755-46ee-b9b4-8bb4e46ebf9e",
  "externalId": "DH-2041",
  "vehicleId": "1b0eb45d-0770-49e7-87d6-b47f0203c86a",
  "season": "WinterStudded",
  "status": "InStorage",
  "isActive": true,
  "storageLocation": {
    "id": "922615d4-816c-4552-a845-9e435f1bb15e",
    "name": "B2-H4"
  },
  "checkedOutAt": null,
  "wheels": [
    {
      "id": "5b26b063-78e3-422b-a24c-64894b84d9e5",
      "position": "FrontRight",
      "rimType": null,
      "tyreBrand": "Nokian",
      "tyreModel": "Hakkapeliitta 10",
      "tyreWidth": 205,
      "tyreProfile": 55,
      "tyreConstruction": "R",
      "rimDiameter": 16,
      "loadIndex": 94,
      "speedIndex": "T",
      "treadDepthMm": 7.8
    }
  ],
  "createdAt": "2026-09-14T08:12:44Z",
  "updatedAt": "2026-10-03T14:02:10Z"
}

Ändra hjuluppsättning

PATCH/v1/wheelsets/{id}

Ändrar hjul, lagerplats, paket eller externalId på en lagrad eller monterad uppsättning. Hjul anges per position och bara de fält som skickas ändras.

Bara en lagrad uppsättning kan flyttas, och bara till en plats med ledigt. En monterad uppsättning byter plats vid hjulskiftet, så ett försök att flytta den ger 409. Säsong och status kan inte ändras här.

Behörighet: wheelsets.write

Sökväg

iduuidkrävs

Postens id.

Anrop

storageLocationIduuid

Flyttar en lagrad uppsättning. Platsen måste ha ledigt. Kan inte tömmas.
packageIduuidkan vara null

Däckhotellpaket. null tar bort kopplingen.
externalIdstringkan vara null

Ditt eget id för uppsättningen. Måste vara ledigt i verkstaden.

Högst 100 tecken
wheelsarray av objekt

Hjul som ska ändras, per position. En position som saknas läggs till.
Fält i wheels
- positionstringkrävs
  
  Vilket hjul.
  
  Värden: FrontRight FrontLeft RearRight RearLeft
- rimTypestringkan vara null
  
  Fälgtyp.
  
  Värden: AluminiumOriginal AluminiumAccessory SteelRim
- tyreBrandstringkan vara null
  
  Däckmärke.
  
  Högst 100 tecken
- tyreModelstringkan vara null
  
  Däckmodell.
  
  Högst 100 tecken
- tyreWidthintegerkan vara null
  
  Däckbredd i mm.
  
  Minst 0
- tyreProfileintegerkan vara null
  
  Profil, höjden i procent av bredden.
  
  Minst 0
- tyreConstructionstringkan vara null
  
  Konstruktion, t.ex. R.
  
  Högst 5 tecken
- rimDiameterintegerkan vara null
  
  Fälgdiameter i tum.
  
  Minst 0
- loadIndexintegerkan vara null
  
  Belastningsindex.
  
  Minst 0
- speedIndexstringkan vara null
  
  Hastighetsindex.
  
  Högst 5 tecken
- treadDepthMmnumberkan vara null
  
  Mönsterdjup i mm.
  
  0–30

Svar

Fälten i svaret

iduuidkrävs

Uppsättningens id i Treadx.
externalIdstringkrävskan vara null

Ditt eget id för uppsättningen, t.ex. numret i ett tidigare system. Unikt inom verkstaden.
vehicleIduuidkrävs

Fordonet uppsättningen hör till.
seasonstringkrävs

Säsong.

Värden: Summer WinterStudded WinterNonStudded
statusstringkrävs

InStorage i lager, Mounted på bilen, ReturnedToCustomer utlämnad.

Värden: Unknown Mounted InStorage ReturnedToCustomer
isActivebooleankrävs

false när uppsättningen är avslutad i däckhotellet.
storageLocationobjektkrävskan vara null

Lagerplatsen uppsättningen har tilldelats. Den ligger kvar medan uppsättningen är monterad, så hjulen står där bara när status är InStorage. null när ingen plats är tilldelad.
Fält i storageLocation
- iduuidkrävs
  
  Lagerplatsens id.
- namestringkrävs
  
  Lagerplatsens namn.
checkedOutAttidkrävskan vara null

När uppsättningen avslutades. null så länge den är aktiv.
wheelsarray av objektkrävs

Hjulen, ett per position.
Fält i wheels
- iduuidkrävs
  
  Hjulets id.
- positionstringkrävs
  
  Position på bilen.
  
  Värden: FrontRight FrontLeft RearRight RearLeft
- rimTypestringkrävskan vara null
  
  Fälgtyp.
  
  Värden: AluminiumOriginal AluminiumAccessory SteelRim
- tyreBrandstringkrävskan vara null
  
  Däckmärke.
- tyreModelstringkrävskan vara null
  
  Däckmodell.
- tyreWidthintegerkrävskan vara null
  
  Däckbredd i mm.
- tyreProfileintegerkrävskan vara null
  
  Profil, höjden i procent av bredden.
- tyreConstructionstringkrävskan vara null
  
  Konstruktion, t.ex. R.
- rimDiameterintegerkrävskan vara null
  
  Fälgdiameter i tum.
- loadIndexintegerkrävskan vara null
  
  Belastningsindex.
- speedIndexstringkrävskan vara null
  
  Hastighetsindex.
- treadDepthMmnumberkrävskan vara null
  
  Mönsterdjup i mm, en decimal.
createdAttidkrävs

När uppsättningen registrerades.
updatedAttidkrävs

Senaste ändringen av uppsättningen, något hjul eller lagerplatsen.

Anrop

curl -X PATCH "https://api.treadx.se/v1/wheelsets/b80bb774-0288-4da1-b201-890375a60c8f" \
  -H "Authorization: Bearer $TREADX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wheels": [
      {
        "position": "FrontLeft",
        "tyreBrand": "Michelin",
        "tyreModel": "Primacy 4",
        "treadDepthMm": 8
      }
    ]
  }'

const response = await fetch("https://api.treadx.se/v1/wheelsets/b80bb774-0288-4da1-b201-890375a60c8f", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.TREADX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    wheels: [
      {
        position: "FrontLeft",
        tyreBrand: "Michelin",
        tyreModel: "Primacy 4",
        treadDepthMm: 8
      }
    ]
  }),
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.treadx.se/v1/wheelsets/b80bb774-0288-4da1-b201-890375a60c8f",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
    json={
        "wheels": [
            {
                "position": "FrontLeft",
                "tyreBrand": "Michelin",
                "tyreModel": "Primacy 4",
                "treadDepthMm": 8
            }
        ]
    },
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;
using System.Text;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var body = """
    {
      "wheels": [
        {
          "position": "FrontLeft",
          "tyreBrand": "Michelin",
          "tyreModel": "Primacy 4",
          "treadDepthMm": 8
        }
      ]
    }
    """;
var response = await http.PatchAsync("/v1/wheelsets/b80bb774-0288-4da1-b201-890375a60c8f",
    new StringContent(body, Encoding.UTF8, "application/json"));
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 200

{
  "id": "a451c889-b755-46ee-b9b4-8bb4e46ebf9e",
  "externalId": "DH-2041",
  "vehicleId": "1b0eb45d-0770-49e7-87d6-b47f0203c86a",
  "season": "WinterStudded",
  "status": "InStorage",
  "isActive": true,
  "storageLocation": {
    "id": "922615d4-816c-4552-a845-9e435f1bb15e",
    "name": "B2-H4"
  },
  "checkedOutAt": null,
  "wheels": [
    {
      "id": "5b26b063-78e3-422b-a24c-64894b84d9e5",
      "position": "FrontRight",
      "rimType": null,
      "tyreBrand": "Nokian",
      "tyreModel": "Hakkapeliitta 10",
      "tyreWidth": 205,
      "tyreProfile": 55,
      "tyreConstruction": "R",
      "rimDiameter": 16,
      "loadIndex": 94,
      "speedIndex": "T",
      "treadDepthMm": 7.8
    }
  ],
  "createdAt": "2026-09-14T08:12:44Z",
  "updatedAt": "2026-10-03T14:02:10Z"
}

Hjulskifte

POST/v1/vehicles/{vehicleId}/tyre-swap

mountWheelsetId är den lagrade uppsättning som sätts på bilen. Den som tas av läggs i lager på platsen som frigörs. Ska den till en annan plats anges removed.storageLocationId.

Vid fordonets första skifte i Treadx är uppsättningen som tas av inte registrerad. Skicka då removed.season och alla fyra hjul, så skapas den.

Allt sker i en transaktion. Ett skifte som skickas igen får 409 eftersom uppsättningen redan är monterad, så ett omförsök efter en timeout byter aldrig tillbaka hjulen.

Behörighet: wheelsets.write

Sökväg

vehicleIduuidkrävs

Bara det här fordonets uppsättningar.

Anrop

mountWheelsetIduuidkrävs

Den lagrade uppsättning som sätts på bilen.
removedobjektkan vara null

Uppsättningen som tas av. Kan utelämnas om den redan finns i Treadx och inget ska ändras.
Fält i removed
- seasonstring
  
  Bara vid fordonets första skifte, när uppsättningen inte finns i Treadx. Då krävs också alla fyra hjul. Annars 409.
  
  Värden: Summer WinterStudded WinterNonStudded
- storageLocationIduuid
  
  En annan plats än den som frigörs. Platsen måste ha ledigt.
- packageIduuidkan vara null
  
  Däckhotellpaket.
- externalIdstringkan vara null
  
  Ditt eget id för uppsättningen.
  
  Högst 100 tecken
- wheelsarray av objekt
  
  Ny data för hjulen som tas av, t.ex. slitage.
  Fält i wheels
  - positionstringkrävs
    
    Vilket hjul.
    
    Värden: FrontRight FrontLeft RearRight RearLeft
  - rimTypestringkan vara null
    
    Fälgtyp.
    
    Värden: AluminiumOriginal AluminiumAccessory SteelRim
  - tyreBrandstringkan vara null
    
    Däckmärke.
    
    Högst 100 tecken
  - tyreModelstringkan vara null
    
    Däckmodell.
    
    Högst 100 tecken
  - tyreWidthintegerkan vara null
    
    Däckbredd i mm.
    
    Minst 0
  - tyreProfileintegerkan vara null
    
    Profil, höjden i procent av bredden.
    
    Minst 0
  - tyreConstructionstringkan vara null
    
    Konstruktion, t.ex. R.
    
    Högst 5 tecken
  - rimDiameterintegerkan vara null
    
    Fälgdiameter i tum.
    
    Minst 0
  - loadIndexintegerkan vara null
    
    Belastningsindex.
    
    Minst 0
  - speedIndexstringkan vara null
    
    Hastighetsindex.
    
    Högst 5 tecken
  - treadDepthMmnumberkan vara null
    
    Mönsterdjup i mm.
    
    0–30
mountedobjektkan vara null

Uppsättningen som sätts på. Bara hjulen kan ändras här.
Fält i mounted
- wheelsarray av objekt
  
  Ny data för hjulen som sätts på, t.ex. nya däck på fälgarna.

Svar

Fälten i svaret

mountedobjektkrävs

En hjuluppsättning.
Fält i mounted
- iduuidkrävs
  
  Uppsättningens id i Treadx.
- externalIdstringkrävskan vara null
  
  Ditt eget id för uppsättningen, t.ex. numret i ett tidigare system. Unikt inom verkstaden.
- vehicleIduuidkrävs
  
  Fordonet uppsättningen hör till.
- seasonstringkrävs
  
  Säsong.
  
  Värden: Summer WinterStudded WinterNonStudded
- statusstringkrävs
  
  InStorage i lager, Mounted på bilen, ReturnedToCustomer utlämnad.
  
  Värden: Unknown Mounted InStorage ReturnedToCustomer
- isActivebooleankrävs
  
  false när uppsättningen är avslutad i däckhotellet.
- storageLocationobjektkrävskan vara null
  
  Lagerplatsen uppsättningen har tilldelats. Den ligger kvar medan uppsättningen är monterad, så hjulen står där bara när status är InStorage. null när ingen plats är tilldelad.
  Fält i storageLocation
  - iduuidkrävs
    
    Lagerplatsens id.
  - namestringkrävs
    
    Lagerplatsens namn.
- checkedOutAttidkrävskan vara null
  
  När uppsättningen avslutades. null så länge den är aktiv.
- wheelsarray av objektkrävs
  
  Hjulen, ett per position.
  Fält i wheels
  - iduuidkrävs
    
    Hjulets id.
  - positionstringkrävs
    
    Position på bilen.
    
    Värden: FrontRight FrontLeft RearRight RearLeft
  - rimTypestringkrävskan vara null
    
    Fälgtyp.
    
    Värden: AluminiumOriginal AluminiumAccessory SteelRim
  - tyreBrandstringkrävskan vara null
    
    Däckmärke.
  - tyreModelstringkrävskan vara null
    
    Däckmodell.
  - tyreWidthintegerkrävskan vara null
    
    Däckbredd i mm.
  - tyreProfileintegerkrävskan vara null
    
    Profil, höjden i procent av bredden.
  - tyreConstructionstringkrävskan vara null
    
    Konstruktion, t.ex. R.
  - rimDiameterintegerkrävskan vara null
    
    Fälgdiameter i tum.
  - loadIndexintegerkrävskan vara null
    
    Belastningsindex.
  - speedIndexstringkrävskan vara null
    
    Hastighetsindex.
  - treadDepthMmnumberkrävskan vara null
    
    Mönsterdjup i mm, en decimal.
- createdAttidkrävs
  
  När uppsättningen registrerades.
- updatedAttidkrävs
  
  Senaste ändringen av uppsättningen, något hjul eller lagerplatsen.
storedobjektkrävs

En hjuluppsättning.
Fält i stored
- iduuidkrävs
  
  Uppsättningens id i Treadx.
- externalIdstringkrävskan vara null
  
  Ditt eget id för uppsättningen, t.ex. numret i ett tidigare system. Unikt inom verkstaden.
- vehicleIduuidkrävs
  
  Fordonet uppsättningen hör till.
- seasonstringkrävs
  
  Säsong.
  
  Värden: Summer WinterStudded WinterNonStudded
- statusstringkrävs
  
  InStorage i lager, Mounted på bilen, ReturnedToCustomer utlämnad.
  
  Värden: Unknown Mounted InStorage ReturnedToCustomer
- isActivebooleankrävs
  
  false när uppsättningen är avslutad i däckhotellet.
- storageLocationobjektkrävskan vara null
  
  Lagerplatsen uppsättningen har tilldelats. Den ligger kvar medan uppsättningen är monterad, så hjulen står där bara när status är InStorage. null när ingen plats är tilldelad.
  Fält i storageLocation
  - iduuidkrävs
    
    Lagerplatsens id.
  - namestringkrävs
    
    Lagerplatsens namn.
- checkedOutAttidkrävskan vara null
  
  När uppsättningen avslutades. null så länge den är aktiv.
- wheelsarray av objektkrävs
  
  Hjulen, ett per position.
  Fält i wheels
  - iduuidkrävs
    
    Hjulets id.
  - positionstringkrävs
    
    Position på bilen.
    
    Värden: FrontRight FrontLeft RearRight RearLeft
  - rimTypestringkrävskan vara null
    
    Fälgtyp.
    
    Värden: AluminiumOriginal AluminiumAccessory SteelRim
  - tyreBrandstringkrävskan vara null
    
    Däckmärke.
  - tyreModelstringkrävskan vara null
    
    Däckmodell.
  - tyreWidthintegerkrävskan vara null
    
    Däckbredd i mm.
  - tyreProfileintegerkrävskan vara null
    
    Profil, höjden i procent av bredden.
  - tyreConstructionstringkrävskan vara null
    
    Konstruktion, t.ex. R.
  - rimDiameterintegerkrävskan vara null
    
    Fälgdiameter i tum.
  - loadIndexintegerkrävskan vara null
    
    Belastningsindex.
  - speedIndexstringkrävskan vara null
    
    Hastighetsindex.
  - treadDepthMmnumberkrävskan vara null
    
    Mönsterdjup i mm, en decimal.
- createdAttidkrävs
  
  När uppsättningen registrerades.
- updatedAttidkrävs
  
  Senaste ändringen av uppsättningen, något hjul eller lagerplatsen.

Anrop

curl -X POST "https://api.treadx.se/v1/vehicles/6c95be28-98a4-414d-9eaa-bffc3388a705/tyre-swap" \
  -H "Authorization: Bearer $TREADX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mountWheelsetId": "9c3f7a12-5e8b-4d21-a6f0-3b9e1c4d7a85",
    "removed": {
      "wheels": [
        {
          "position": "FrontLeft",
          "treadDepthMm": 3.1
        },
        {
          "position": "FrontRight",
          "treadDepthMm": 3.4
        }
      ]
    }
  }'

const response = await fetch("https://api.treadx.se/v1/vehicles/6c95be28-98a4-414d-9eaa-bffc3388a705/tyre-swap", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TREADX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    mountWheelsetId: "9c3f7a12-5e8b-4d21-a6f0-3b9e1c4d7a85",
    removed: {
      wheels: [
        {
          position: "FrontLeft",
          treadDepthMm: 3.1
        },
        {
          position: "FrontRight",
          treadDepthMm: 3.4
        }
      ]
    }
  }),
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.treadx.se/v1/vehicles/6c95be28-98a4-414d-9eaa-bffc3388a705/tyre-swap",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
    json={
        "mountWheelsetId": "9c3f7a12-5e8b-4d21-a6f0-3b9e1c4d7a85",
        "removed": {
            "wheels": [
                {
                    "position": "FrontLeft",
                    "treadDepthMm": 3.1
                },
                {
                    "position": "FrontRight",
                    "treadDepthMm": 3.4
                }
            ]
        }
    },
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;
using System.Text;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var body = """
    {
      "mountWheelsetId": "9c3f7a12-5e8b-4d21-a6f0-3b9e1c4d7a85",
      "removed": {
        "wheels": [
          {
            "position": "FrontLeft",
            "treadDepthMm": 3.1
          },
          {
            "position": "FrontRight",
            "treadDepthMm": 3.4
          }
        ]
      }
    }
    """;
var response = await http.PostAsync("/v1/vehicles/6c95be28-98a4-414d-9eaa-bffc3388a705/tyre-swap",
    new StringContent(body, Encoding.UTF8, "application/json"));
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 200

{
  "mounted": {
    "id": "a451c889-b755-46ee-b9b4-8bb4e46ebf9e",
    "externalId": "DH-2041",
    "vehicleId": "1b0eb45d-0770-49e7-87d6-b47f0203c86a",
    "season": "WinterStudded",
    "status": "InStorage",
    "isActive": true,
    "storageLocation": {
      "id": "922615d4-816c-4552-a845-9e435f1bb15e",
      "name": "B2-H4"
    },
    "checkedOutAt": null,
    "wheels": [
      {
        "id": "5b26b063-78e3-422b-a24c-64894b84d9e5",
        "position": "FrontRight",
        "rimType": null,
        "tyreBrand": "Nokian",
        "tyreModel": "Hakkapeliitta 10",
        "tyreWidth": 205,
        "tyreProfile": 55,
        "tyreConstruction": "R",
        "rimDiameter": 16,
        "loadIndex": 94,
        "speedIndex": "T",
        "treadDepthMm": 7.8
      }
    ],
    "createdAt": "2026-09-14T08:12:44Z",
    "updatedAt": "2026-10-03T14:02:10Z"
  },
  "stored": {
    "id": "a451c889-b755-46ee-b9b4-8bb4e46ebf9e",
    "externalId": "DH-2041",
    "vehicleId": "1b0eb45d-0770-49e7-87d6-b47f0203c86a",
    "season": "WinterStudded",
    "status": "InStorage",
    "isActive": true,
    "storageLocation": {
      "id": "922615d4-816c-4552-a845-9e435f1bb15e",
      "name": "B2-H4"
    },
    "checkedOutAt": null,
    "wheels": [
      {
        "id": "5b26b063-78e3-422b-a24c-64894b84d9e5",
        "position": "FrontRight",
        "rimType": null,
        "tyreBrand": "Nokian",
        "tyreModel": "Hakkapeliitta 10",
        "tyreWidth": 205,
        "tyreProfile": 55,
        "tyreConstruction": "R",
        "rimDiameter": 16,
        "loadIndex": 94,
        "speedIndex": "T",
        "treadDepthMm": 7.8
      }
    ],
    "createdAt": "2026-09-14T08:12:44Z",
    "updatedAt": "2026-10-03T14:02:10Z"
  }
}

Lagerplatser

Verkstadens lagerplatser. Hämta id:n här när en hjuluppsättning ska registreras eller flyttas.

Lista lagerplatser

GET/v1/storage-locations

Alla lagerplatser sorterade på namn, även inaktiva. Kommer på en sida: nextCursor är alltid null. Bara lagrade uppsättningar tar plats.

Behörighet: storage.read

Svar

Fälten i svaret

dataarray av objektkrävs

Lagerplatserna.
Fält i data
- iduuidkrävs
  
  Lagerplatsens id.
- namestringkrävs
  
  Namn. Kan ändras i Treadx, så använd alltid id.
- descriptionstringkrävskan vara null
  
  Beskrivning.
- isActivebooleankrävs
  
  Om platsen används.
- maxWheelsetsintegerkrävs
  
  Antal uppsättningar platsen rymmer.
- storedWheelsetsintegerkrävs
  
  Antal uppsättningar i lager på platsen.
- freePlacesintegerkrävs
  
  Lediga platser.
nextCursorstringkrävskan vara null

Alltid null.

Anrop

curl "https://api.treadx.se/v1/storage-locations" \
  -H "Authorization: Bearer $TREADX_API_KEY"

const response = await fetch("https://api.treadx.se/v1/storage-locations", {
  headers: { Authorization: `Bearer ${process.env.TREADX_API_KEY}` },
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.treadx.se/v1/storage-locations",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var response = await http.GetAsync("/v1/storage-locations");
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 200

{
  "data": [
    {
      "id": "328f2db0-04f8-4450-ab6e-3c60af276ecd",
      "name": "B2-H4",
      "description": "Hylla 4, rad B2",
      "isActive": true,
      "maxWheelsets": 4,
      "storedWheelsets": 3,
      "freePlaces": 1
    }
  ],
  "nextCursor": "eyJ1IjoiMjAyNi0xMC0wM1QxNDowMjoxMFoifQ"
}

Paket

Verkstadens däckhotellpaket. Hämta id:n här när en hjuluppsättning ska kopplas till ett paket.

Lista paket

GET/v1/packages

Verkstadens aktiva paket i verkstadens egen ordning, med aktiva tillägg. Kommer på en sida: nextCursor är alltid null.

Behörighet: packages.read

Svar

Fälten i svaret

dataarray av objektkrävs

Paketen.
Fält i data
- iduuidkrävs
  
  Paketets id.
- namestringkrävs
  
  Namn.
- descriptionstringkrävskan vara null
  
  Beskrivning.
- pricenumberkrävskan vara null
  
  Pris i kronor, som verkstaden angett det.
- includesWashbooleankrävs
  
  Om tvätt ingår.
- addonsarray av objektkrävs
  
  Tillägg som kan väljas till paketet.
  Fält i addons
  - namestringkrävs
    
    Namn.
  - descriptionstringkrävskan vara null
    
    Beskrivning.
nextCursorstringkrävskan vara null

Alltid null.

Anrop

curl "https://api.treadx.se/v1/packages" \
  -H "Authorization: Bearer $TREADX_API_KEY"

const response = await fetch("https://api.treadx.se/v1/packages", {
  headers: { Authorization: `Bearer ${process.env.TREADX_API_KEY}` },
});
if (!response.ok) throw new Error(`Treadx svarade ${response.status}`);
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.treadx.se/v1/packages",
    headers={"Authorization": f"Bearer {os.environ['TREADX_API_KEY']}"},
)
response.raise_for_status()
data = response.json()

using System.Net.Http.Headers;

using var http = new HttpClient { BaseAddress = new Uri("https://api.treadx.se") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("TREADX_API_KEY"));

var response = await http.GetAsync("/v1/packages");
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

Svar 200

{
  "data": [
    {
      "id": "f25777e6-fad3-455d-9262-a967789c0aec",
      "name": "Däckhotell Bas",
      "description": "Förvaring en säsong",
      "price": 595,
      "includesWash": true,
      "addons": [
        {
          "name": "Hjultvätt",
          "description": "Tvätt av fälgar före förvaring"
        }
      ]
    }
  ],
  "nextCursor": "eyJ1IjoiMjAyNi0xMC0wM1QxNDowMjoxMFoifQ"
}