TrustSeks API

Lägg till företag i er TrustSek-organisation och starta kontroller från era egna system, med ett enda autentiserat anrop.

Senast granskad 27 september 2026

Öppet API

Endpoint: POST /v1/subjects
Starta kontroll: ?scan=true
Autentisering: Bearer es_…
Svar: 201 Created
Version: 1.0.0

API:et är litet i dag, och den här sidan beskriver exakt vad det gör. Det har en enda endpoint. Den skapar ett företag i er organisation och kan starta en kontroll i samma anrop. Kontrollen körs sedan precis som om den hade startats i appen, och ni läser resultatet i appen.

Autentisering

Varje anrop kräver en API-nyckel, som skickas som Bearer-token i headern Authorization.

Nycklar skapas i appen under Settings → API Keys. Bara organisationens ägare kan skapa en nyckel.
En nyckel börjar med es_. Den visas en enda gång, när ni skapar den, så spara den direkt i er hemlighetshanterare.
En nyckel hör till er organisation. Allt den skapar hamnar i den organisationen.
En återkallad nyckel slutar fungera omedelbart.

En nyckel som saknas, är felformaterad, är okänd eller har återkallats ger 401.

Bas-URL

https://api.trustsek.com/v1

Lägg till ett företag och starta en kontroll

POST /v1/subjects skapar ett företag (i API:et kallat ”subject”) i er organisation. Lägg till ?scan=true för att starta en kontroll så fort företaget har skapats.

curl -X POST "https://api.trustsek.com/v1/subjects?scan=true" \
  -H "Authorization: Bearer es_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Exempel AB", "primaryDomain": "example.com"}'

Anropets innehåll

Fält	Typ	Obligatoriskt	Kommentar
`name`	string	Ja	1 till 200 tecken.
`primaryDomain`	string	Ja	Ett domännamn som `example.com`, utan `https://` och utan sökväg. Sparas med gemener.
`domains`	array av strings	Nej	Andra domäner som hör till företaget.
`tags`	array av strings	Nej	Era egna etiketter, till exempel en kund eller ett bestånd.
`contactEmail`	string	Nej	Måste vara en giltig e-postadress.
`contactName`	string	Nej	Högst 120 tecken.

Frågeparametrar

Parameter	Värden	Effekt
`scan`	`true` eller `1`	Startar en kontroll direkt efter att företaget har skapats. Alla andra värden, eller ingen parameter alls, skapar bara företaget.

Svar

Ett lyckat anrop ger 201 Created:

{
  "id": "3f1c2a9e-7b4d-4e7a-9c1f-2d8e5b6a0c41",
  "name": "Exempel AB",
  "primaryDomain": "example.com",
  "createdAt": "2026-09-27T09:30:00.000Z",
  "runId": "9a7e4c10-5d2b-4f3e-8a61-0b9c7d2e4f58"
}

id är det nya företagets id.
runId är id för kontrollen som startades. Det är null om ni inte skickade med scan=true. Det är också null om företaget skapades men kontrollen inte kunde köas, så kontrollera värdet i stället för att anta att en kontroll pågår.

Id:na ovan är exempel.

Fel

Status	När	Svar
`400`	Innehållet klarar inte valideringen, till exempel om `name` saknas eller domänen är felformaterad.	`{"error": "Validation error", "details": [...]}` med varje problem listat.
`401`	API-nyckeln saknas, är felformaterad, är okänd eller har återkallats.	`{"error": "Unauthorized: ..."}` med orsaken.
`500`	Något gick fel hos oss.	`{"error": "Internal server error"}`

Varje anrop skapar ett nytt företag. Endpointen kontrollerar inte om domänen redan finns i er organisation, så undvik att skicka om ett anrop som kanske redan har gått igenom.

Det här gör API:et inte än

API:et returnerar inte poäng, fynd eller status för kontroller. Det finns inga endpoints för att lista, ändra eller ta bort företag, och inga webhooks. När ni har startat en kontroll ser ni resultatet i appen, på samma sätt som för en kontroll som startats där.

Det finns inga publicerade gränser för antal anrop, inga SDK:er och inga servicenivåer för API:et.

Behöver ni något som API:et inte gör än? Berätta det för oss. Önskemålen styr vad vi bygger härnäst.

Så poängsätts kontrollen

En kontroll som startas via API:et använder samma sex moduler, vikter och poängpolicy som en kontroll som startas i appen. Metoden förklarar hur underlaget blir en poäng och vad poängen inte kan se.

Vilka som använder det

IT-partner använder det för att lägga in många kunddomäner på en gång i stället för att skriva in dem en och en i appen; läs mer under för IT-partner. Försäkringsbolag och mäklare använder det för att lägga in de domäner de offererar; läs mer under för försäkring.

För att få en nyckel skapar ni ett konto eller loggar in i appen och öppnar Settings → API Keys. Priser förklarar vem som betalar för vad. Frågor om API:et skickar ni via kontaktsidan.

Skaffa en API-nyckel Fråga om API:et