Kvickd Tidrapportering API

The Tidrapportering API from Kvickd — 5 operation(s) for tidrapportering.

GitHub OpenAPI

Operations 6

POST /api/v1/companies/{orgnr}/time-entries Lägg in tidpost #
GET /api/v1/companies/{orgnr}/time-entries Lista tidposter #
DELETE /api/v1/companies/{orgnr}/time-entries/{entry_id} Ta bort tidpost #
GET /api/v1/companies/{orgnr}/payroll-time-basis Löneunderlag ur tidrapporter #
GET /api/v1/companies/{orgnr}/time-reporting Tidrapportering: länk och läge #
POST /api/v1/companies/{orgnr}/time-entries/review Avvisa eller återställ tidposter #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kvickd-com:kvickd-com-tidrapportering-api"
All apis
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.

Get an API 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 Specification

kvickd-com-tidrapportering-api-openapi.yml Raw ↑
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