Kvickd Tidrapportering API
The Tidrapportering API from Kvickd — 5 operation(s) for tidrapportering.
The Tidrapportering API from Kvickd — 5 operation(s) for tidrapportering.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/kvickd-com:kvickd-com-tidrapportering-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Kvickd Tidrapportering API
version: '1'
description: Allt som går att se och göra i Kvickd, som REST-anrop. Varje adress är ett MCP-verktyg med samma namn (operationId), samma behörigheter och samma credits. Se kvickd.com/api.
summary: 'REST API for Kvickd, bookkeeping for Swedish small businesses (AB, enskild firma, handelsbolag): ledger, invoices, VAT, payroll, year-end and annual reports. Every endpoint is also an MCP tool with the same name.'
termsOfService: https://www.kvickd.com/villkor#api
contact:
name: Kvickd
url: https://www.kvickd.com/api
email: hello@kvickd.com
x-logo:
url: https://www.kvickd.com/kvickd-logo.png
altText: Kvickd
servers:
- url: https://api.kvickd.com
security:
- ApiKey: []
- Bearer: []
tags:
- name: Tidrapportering
paths:
/api/v1/companies/{orgnr}/time-entries:
post:
operationId: add_time_entry
tags:
- Tidrapportering
summary: Lägg in tidpost
description: 'Lägg in en tidpost åt en anställd (t.ex. från en tidlapp). Högst 24 timmar per dag. Posten väntar alltid på attest: tidrapporter attesteras av en människa i Kvickd under Lön, Tidrapporter, aldrig via den här kopplingen. Scope payroll. Argument: orgnr, employee_id, work_date (YYYY-MM-DD), hours (t.ex. 7.5); valfritt kind (arbete|overtid|ob|sjuk|semester|vab|ledig, default arbete), project (kund eller projekt), note.'
x-kvickd-read-only: false
x-kvickd-mcp-tool: add_time_entry
responses:
'200':
description: Verktygets svar
content:
application/json:
schema:
$ref: '#/components/schemas/Result'
'400':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'415':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'422':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
required: true
content:
application/json:
schema:
properties:
employee_id:
title: Employee Id
type: integer
work_date:
title: Work Date
type: string
hours:
title: Hours
type: number
kind:
default: arbete
title: Kind
type: string
project:
anyOf:
- type: string
- type: 'null'
default: null
title: Project
note:
anyOf:
- type: string
- type: 'null'
default: null
title: Note
required:
- employee_id
- work_date
- hours
title: add_time_entryArguments
type: object
parameters:
- name: orgnr
in: path
required: true
schema:
description: Bolagets organisationsnummer, 10 siffror med eller utan bindestreck, t.ex. 559900-1004. Hämta med list_companies.
title: Orgnr
type: string
- name: Idempotency-Key
in: header
required: false
schema:
type: string
maxLength: 255
description: Valfri. Samma nyckel inom ett dygn ger samma svar i stället för att anropet körs igen.
get:
operationId: list_time_entries
tags:
- Tidrapportering
summary: Lista tidposter
description: Listar rapporterade tidposter, nyast först, valfritt filtrerade på datum, anställd och status. Använd för att granska tid (attesten görs i Kvickd); för en sammanställning inför lönen, använd get_payroll_time_basis, och för länk och koder, get_time_reporting. Returnerar per post id, datum, typ, minuter och timmar, projekt, notering, status, anställd, vem som attesterat och ev. lönekörning, samt minuter per status och totalt. Läser bara, ändrar inget.
x-kvickd-read-only: true
x-kvickd-mcp-tool: list_time_entries
responses:
'200':
description: Verktygets svar
content:
application/json:
schema:
$ref: '#/components/schemas/Result'
'400':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'415':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'422':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
parameters:
- name: orgnr
in: path
required: true
schema:
description: Bolagets organisationsnummer, 10 siffror med eller utan bindestreck, t.ex. 559900-1004. Hämta med list_companies.
title: Orgnr
type: string
- name: date_from
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: null
description: 'Valfritt: från och med datum, ÅÅÅÅ-MM-DD, t.ex. 2026-10-01.'
title: Date From
description: 'Valfritt: från och med datum, ÅÅÅÅ-MM-DD, t.ex. 2026-10-01.'
- name: date_to
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: null
description: 'Valfritt: till och med datum, ÅÅÅÅ-MM-DD, t.ex. 2026-10-31.'
title: Date To
description: 'Valfritt: till och med datum, ÅÅÅÅ-MM-DD, t.ex. 2026-10-31.'
- name: employee_id
in: query
required: false
schema:
anyOf:
- type: integer
- type: 'null'
default: null
description: 'Valfritt: den anställdes id (heltal), från list_employees.'
title: Employee Id
description: 'Valfritt: den anställdes id (heltal), från list_employees.'
- name: status
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: null
description: 'Valfritt: rapporterad, attesterad, avvisad eller utbetald.'
title: Status
description: 'Valfritt: rapporterad, attesterad, avvisad eller utbetald.'
/api/v1/companies/{orgnr}/time-entries/{entry_id}:
delete:
operationId: delete_time_entry
tags:
- Tidrapportering
summary: Ta bort tidpost
description: 'Ta bort en tidpost som inte ingår i en bokförd lönekörning. Scope payroll. Argument: orgnr, entry_id.'
x-kvickd-read-only: false
x-kvickd-mcp-tool: delete_time_entry
responses:
'200':
description: Verktygets svar
content:
application/json:
schema:
$ref: '#/components/schemas/Result'
'400':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'415':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'422':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
parameters:
- name: orgnr
in: path
required: true
schema:
description: Bolagets organisationsnummer, 10 siffror med eller utan bindestreck, t.ex. 559900-1004. Hämta med list_companies.
title: Orgnr
type: string
- name: entry_id
in: path
required: true
schema:
title: Entry Id
type: integer
- name: Idempotency-Key
in: header
required: false
schema:
type: string
maxLength: 255
description: Valfri. Samma nyckel inom ett dygn ger samma svar i stället för att anropet körs igen.
/api/v1/companies/{orgnr}/payroll-time-basis:
get:
operationId: get_payroll_time_basis
tags:
- Tidrapportering
summary: Löneunderlag ur tidrapporter
description: 'Löneunderlag ur tidrapporteringen: attesterade, ännu inte utbetalda timmar per anställd t.o.m. ett datum. Varje anställd har components (förslag på lönearter: timlön = timmar × timlön, övertid och OB om ersättning per timme är angiven, semesterersättning om den betalas med varje lön) och entry_ids. Skicka components och time_entry_ids = entry_ids i entries till calc_payroll/run_payroll, så märks timmarna som utbetalda. Frånvaro (absence) och notes visar det som måste hanteras manuellt. Räkna aldrig om beloppen själv. Scope view. Argument: orgnr; valfritt through (YYYY-MM-DD, default i dag).'
x-kvickd-read-only: true
x-kvickd-mcp-tool: get_payroll_time_basis
responses:
'200':
description: Verktygets svar
content:
application/json:
schema:
$ref: '#/components/schemas/Result'
'400':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'415':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'422':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
parameters:
- name: orgnr
in: path
required: true
schema:
description: Bolagets organisationsnummer, 10 siffror med eller utan bindestreck, t.ex. 559900-1004. Hämta med list_companies.
title: Orgnr
type: string
- name: through
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
default: null
title: Through
/api/v1/companies/{orgnr}/time-reporting:
get:
operationId: get_time_reporting
tags:
- Tidrapportering
summary: 'Tidrapportering: länk och läge'
description: 'Visar läget för tidrapporteringen: bolagets länk för tidrapportering, vilka anställda som har en personlig kod och hur mycket som väntar på attest. Använd för att ge en anställd länken eller se om något väntar på attest i Kvickd; för själva tidposterna, använd list_time_entries. Returnerar länken (om den är aktiverad), aktiva anställda med om de har kod och med timlön och månadslön i öre, antal poster och minuter som väntar på attest och vilka tidstyper som finns. Koderna visas aldrig. Läser bara, ändrar inget.'
x-kvickd-read-only: true
x-kvickd-mcp-tool: get_time_reporting
responses:
'200':
description: Verktygets svar
content:
application/json:
schema:
$ref: '#/components/schemas/Result'
'400':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'415':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'422':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
parameters:
- name: orgnr
in: path
required: true
schema:
description: Bolagets organisationsnummer, 10 siffror med eller utan bindestreck, t.ex. 559900-1004. Hämta med list_companies.
title: Orgnr
type: string
/api/v1/companies/{orgnr}/time-entries/review:
post:
operationId: review_time_entries
tags:
- Tidrapportering
summary: Avvisa eller återställ tidposter
description: 'Skicka tillbaka rapporterade tidposter till den anställde eller återställ avvisade. status = avvisad (en rapporterad post skickas tillbaka; den anställde ser note och kan rätta) eller rapporterad (en avvisad post återställs och väntar på attest igen). Attest görs inte här: tidrapporter attesteras, och en attest ändras, av en människa i Kvickd under Lön, Tidrapporter. Attesterade och utbetalda poster kan inte ändras här. Scope payroll. Argument: orgnr, entry_ids, status; valfritt note.'
x-kvickd-read-only: false
x-kvickd-mcp-tool: review_time_entries
responses:
'200':
description: Verktygets svar
content:
application/json:
schema:
$ref: '#/components/schemas/Result'
'400':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'415':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'422':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Fel
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
required: true
content:
application/json:
schema:
properties:
entry_ids:
items: {}
title: Entry Ids
type: array
status:
title: Status
type: string
note:
anyOf:
- type: string
- type: 'null'
default: null
title: Note
required:
- entry_ids
- status
title: review_time_entriesArguments
type: object
parameters:
- name: orgnr
in: path
required: true
schema:
description: Bolagets organisationsnummer, 10 siffror med eller utan bindestreck, t.ex. 559900-1004. Hämta med list_companies.
title: Orgnr
type: string
- name: Idempotency-Key
in: header
required: false
schema:
type: string
maxLength: 255
description: Valfri. Samma nyckel inom ett dygn ger samma svar i stället för att anropet körs igen.
components:
schemas:
Result:
type: object
properties:
data: {}
Error:
type: object
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
message:
type: string
request_id:
type: string
securitySchemes:
ApiKey:
type: apiKey
in: header
name: X-API-Key
Bearer:
type: http
scheme: bearer
description: 'Samma API-nyckel som Authorization: Bearer kvickd_key_...'
externalDocs:
description: API-dokumentation
url: https://www.kvickd.com/api