How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Visma Employee API

The Employee API from Visma — 6 operation(s) for employee.

Visma Employee API is one of 193 APIs that Visma publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Employee. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, rate-limit docs, and a support channel.

This API exposes 8 operations across 6 paths, and defines 67 schemas. It is described by OpenAPI 3.2.0, at version v1.

Requests are made against a single base URL, https://api.finance.visma.net.

8 operations 6 paths 67 schemas 5 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v1
Base URL
https://api.finance.visma.net
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Visma Employee API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (interactiveapi) using the authorizationCode flow, exposing 5 scopes.

Paths & Operations 8

Across 6 paths, the API surfaces 8 operations — 5 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Employee 8
GET
/v1/employee/{employeeCd}
Get a specific employee
Employee_GetEmployeeByemployeeCd 2 params → 200202
PUT
/v1/employee/{employeeCd}
Updates a specific employee
Employee_PutByemployeeCd 3 params body → 204412202
GET
/v1/employee
Get a range of employees - ScreenId=EP203000 Request page size must be lower or…
Employee_GetAllEmployees 10 params → 200202
POST
/v1/employee
Create an employee
Employee_CreateEmployee 1 param body → 201202
GET
/v1/employee/{EmployeeCd}/timecards
Get a specific employee time cards
Employee_GetEmployeeTimeCards 12 params → 200202
GET
/v1/employee/{employeeCd}/expenseClaim
Get expense claims for a specific employee
Employee_GetEmployeeExpenseClaimsByemployeeCd 14 params → 200202
GET
/v1/employee/{employeeCd}/expenseReceipt
Get expense receipts for a specific employee
Employee_GetEmployeeExpenseReceiptsByemployeeCd 11 params → 200202
POST
/v1/employee/action/changeEmployeeCd/{internalId}
Updates the EmployeeNr for the specified employee
Employee_ChangeEmployeeNrActionByinternalId 3 params body → 200412202

Schemas 67

The contract defines 67 schemas that model the data the API accepts and returns. The most detailed are ExpenseClaimDetailDto (30 properties), ExpenseReceiptDto (30 properties), TimeCardDto (20 properties), ExpenseClaimDto (20 properties). Each schema is shown below with its type and property counts.

departmentInEmployeeUpdateDto
object
Mandatory field: General information tab Employee section Department The department the employee works for.
1 property
customerInExpenseClaimDetailDto
object
Customer The identifier of the customer associated with the expense.
2 properties
claimedByInExpenseClaimDto
object
Mandatory field: The top part Claimed by The employee who is claiming the expenses. If the claim is released, an Accounts Payable bill will be generated to thi…
3 properties
statusInEmployeeCreateDTO
object
Mandatory field: The top part Status The status of the employee. The following options are available: Active, On hold, Hold payments, Inactive, One-time.
1 property
projectTaskInExpenseClaimDetailDto
object
Project task The task associated with the contract or project.
3 properties
salesSubInExpenseReceiptDto
object
Receipt details tab Financial details section Sales sub. The corresponding subaccount the system uses to record the amount to charge the customer for.
3 properties
expenseAccountInExpenseClaimDetailDto
object
Mandatory field: Expense account The expense account to which the system should record the part of the expense to be paid back to the employee.
6 properties
AttachmentDto
object
3 properties
projectTaskInTimeCardMaterialsDto
object
Project task The project task that the employee worked on.
3 properties
projectTaskInTimeCardSummaryDto
object
Project task The project task that the employee worked on.
3 properties
TimeCardMaterialsDto
object
15 properties
EmployeeUpdateDto
object
8 properties 1 required
earningTypeInTimeCardSummaryDto
object
Earning type The type of the work time spent by the employee
7 properties
locationInExpenseClaimDto
object
The top part Location The company location associated with the claim.
2 properties
expenseAccountInExpenseReceiptDto
object
Receipt details tab Financial details section Expense account The expense account to which the system records the part of the expense to be paid back to the em…
3 properties
InventoryNumberDescriptionDto
object
2 properties
ExpenseClaimDetailDto
object
30 properties
salesAccountInExpenseClaimDetailDto
object
Sales account The sales account to which the system should record the part of the amount to charge the customer for. This is applicable only when a customer ha…
6 properties
expenseItemInExpenseClaimDetailDto
object
Mandatory field: Expense item The expense identifier, if an expense of this type is listed as an inventory nonstock item.
2 properties
DtoValueOfString
object
1 property
CompanyTreeInfoDto
object
4 properties
ExpenseClaimDto
object
This class represents a Expense Claim in ExpenseClaimController. Used for getting data.
20 properties
employeeInTimeCardDto
object
The top part Employee The name of the employee whose time card is currently open.
3 properties
contactInEmployeeDto
object
General information tab Contact section
14 properties
projectInExpenseReceiptDto
object
Receipt details tab Expense details section Project/contract The project or contract, which should be specified if the employee incurred the expenses while wor…
3 properties
expenseSubInExpenseReceiptDto
object
Receipt details tab Financial details section Expense sub. The corresponding subaccount the system uses to record the part of the expense to be paid back to th…
3 properties
countyInAddressDto
object
County The county or province.
2 properties
countryInAddressDto
object
Country The country.
4 properties
ChangeEmployeeNrActionDto
object
1 property
addressInEmployeeUpdateDto
object
General information tab Address info section
7 properties
branchInExpenseReceiptDto
object
Mandatory field: The top part Branch The company branch that will incur the expenses.
2 properties
projectTaskInExpenseReceiptDto
object
Receipt details tab Expense details section Project task The project task to which the expenses are related.
3 properties
EmployeeContactUpdateDto
object
8 properties 2 required
locationInExpenseClaimDetailDto
object
Location The identifier of the customer location associated with the expense.
2 properties
taxCategoryInExpenseClaimDetailDto
object
VAT category The VAT category associated with the expense item.
2 properties
projectInTimeCardMaterialsDto
object
Mandatory field: Project The project that the employee worked on.
3 properties
AddressUpdateDto
object
7 properties
BackgroundApiAcceptedDto
object
2 properties
ExpenseReceiptDto
object
This class represents a Expense Receipt in ExpenseReceiptController. Used by getting data.
30 properties
projectInExpenseClaimDetailDto
object
Mandatory field: Project The project or customer contract associated with the expense claim, if the work performed was for a project or contract. Project Task…
3 properties
employeeClassInEmployeeDto
object
Additional information about Employee User ///
2 properties
locationInExpenseReceiptDto
object
Receipt details tab Financial details section Location The location of the customer related to the expenses.
2 properties
contactInEmployeeUpdateDto
object
General information tab Contact section
8 properties
currencyInExpenseReceiptDto
object
Both tabs Currency The currency of the expense receipt.
2 properties
departmentInExpenseClaimDto
object
Mandatory field: The top part Department ID The department associated with the expense claim.
2 properties
customerInExpenseReceiptDto
object
Receipt details tab Financial details section Customer The customer, which should be specified if the employee incurred the expenses while working for a partic…
2 properties
statusInEmployeeUpdateDto
object
Mandatory field: The top part Status The status of the employee. The following options are available: Active, On hold, Hold payments, Inactive, One-time.
1 property
expenseClaimInExpenseReceiptDto
object
Receipt details tab Expense details section Expense claim The expense claim with which the expense receipt is associated.
2 properties
DtoValueOfBoolean
object
1 property
MetadataDto
object
2 properties
weekInTimeCardDto
object
The top part Week The week for which the time card has been created.
2 properties
TimeCardDto
object
20 properties
claimedByInExpenseReceiptDto
object
Mandatory field: The top part Claimed by The name of the employee who is claiming the expenses.
17 properties
imageInExpenseReceiptDto
object
Receipt details tab Image section
3 properties
customerInExpenseClaimDto
object
The top part Customer The applicable customer.
2 properties
salesAccountInExpenseReceiptDto
object
Receipt details tab Financial details section Sales account The sales account to which the system records the part of the amount to charge the customer for.
3 properties
salesSubaccountInExpenseClaimDetailDto
object
Sales sub. The corresponding subaccount the system uses to record the amount to charge the customer for. This is applicable only when a customer has been speci…
3 properties
addressInEmployeeDto
object
General information tab Address info section
8 properties
ChangeEmployeeNrActionResultDto
object
3 properties
expenseSubaccountInExpenseClaimDetailDto
object
MAndatory field: Expense sub. The corresponding subaccount the system uses to record the part of the expense to be paid back to the employee.
3 properties
projectInTimeCardSummaryDto
object
Mandatory field: Project The project that the employee worked on.
3 properties
branchInExpenseClaimDetailDto
object
Mandatory field: Branch The branch that will reimburse the expenses to the employee.
2 properties
EmployeeDto
object
This class represents an Employee in EmployeeController. Used for getting data.
17 properties
taxCategoryInExpenseReceiptDto
object
Receipt details tab Expense details section VAT category The tax category for the expense receipt.
2 properties
BranchNumberDto
object
2 properties
EmployeeCreateDTO
object
8 properties 6 required
TimeCardSummaryDto
object
19 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

visma-employee-api-openapi.yml Raw ↑

Other APIs Visma publishes across the network.

Visma Business NXT GraphQL API
Visma Account API
Visma Accounts API
Visma Agreements API
Visma Allocation Periods API
Visma Approval API
Visma App Store Activation Status API
Visma Article Account Codings API
Visma Article Labels API
Visma Articles API
Visma Attachment API
Visma Attachment Links API
Where this information came from

This is an independent, third-party profile of Visma Employee API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.