aid: nmbrs url: https://raw.githubusercontent.com/api-evangelist/nmbrs/refs/heads/main/apis.yml name: Nmbrs kind: company description: >- Nmbrs (Visma Nmbrs) is cloud HR and payroll software for the Netherlands and Sweden, widely used by employers, accountants, and payroll service providers. Nmbrs exposes its HRIS and payroll data through a public API in two generations. The current, forward-looking interface is a REST API served from https://api.nmbrsapp.com, authenticated with OAuth 2.0 (Authorization Code flow via identityservice.nmbrs.com) plus a per-product subscription key, with granular scopes over companies, employees, employments, salaries, wage components, payruns, and absences. The older SOAP API (api.nmbrs.nl/soap/v3 - EmployeeService, CompanyService, DebtorService) remains available for existing integrations but is deprecated and scheduled to be retired on 1 March 2027, after which REST is the only supported API. image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg tags: - Human Resources - HRIS - Payroll - Employee Management - HR - Absence Management - Netherlands - Sweden - SOAP - REST created: '2026-07-11' modified: '2026-07-11' specificationVersion: '0.19' apis: - aid: nmbrs:nmbrs-companies-api name: Nmbrs Companies API tags: - Human Resources - Companies - Employer image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://developer.nmbrs.com/docs baseURL: https://api.nmbrsapp.com properties: - url: https://developer.nmbrs.com/docs type: Documentation - url: https://nmbrs.stoplight.io/docs/nmbrs-restapi type: APIReference - url: openapi/nmbrs-openapi.yml type: OpenAPI - url: collections/nmbrs.postman_collection.json type: PostmanCollection - url: collections/nmbrs.opencollection.json type: OpenCollection description: >- REST access to the companies (employers) inside a Nmbrs environment - list the companies accessible to the subscription and use them as the parent scope for employees, payruns, and payroll data. GET https://api.nmbrsapp.com/api/companies is a confirmed live endpoint (returns 401 without OAuth token + subscription key). - aid: nmbrs:nmbrs-employees-api name: Nmbrs Employees API tags: - Human Resources - HRIS - Employee Management image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://nmbrs.stoplight.io/docs/nmbrs-restapi/a31578b069764-get-employee-list baseURL: https://api.nmbrsapp.com properties: - url: https://developer.nmbrs.com/docs type: Documentation - url: https://nmbrs.stoplight.io/docs/nmbrs-restapi/a31578b069764-get-employee-list type: APIReference - url: openapi/nmbrs-openapi.yml type: OpenAPI - url: collections/nmbrs.postman_collection.json type: PostmanCollection - url: collections/nmbrs.opencollection.json type: OpenCollection description: >- Core HRIS surface - list a company's employees and read individual employee records including personal information (name, date of birth, contact details). Guarded by the employee.info and employee.info.read OAuth scopes. Endpoint paths are modeled from the published Stoplight resource groups. - aid: nmbrs:nmbrs-employments-api name: Nmbrs Employments API tags: - Human Resources - Employment - Contracts image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://nmbrs.stoplight.io/docs/nmbrs-restapi baseURL: https://api.nmbrsapp.com properties: - url: https://developer.nmbrs.com/docs type: Documentation - url: https://nmbrs.stoplight.io/docs/nmbrs-restapi type: APIReference - url: openapi/nmbrs-openapi.yml type: OpenAPI - url: collections/nmbrs.postman_collection.json type: PostmanCollection - url: collections/nmbrs.opencollection.json type: OpenCollection description: >- Employment contracts and employment history for an employee - start/end dates and contract type - under the employee.employment scope. Endpoints modeled from documented resource groups (endpointsModeled). - aid: nmbrs:nmbrs-payroll-api name: Nmbrs Payroll & Payruns API tags: - Payroll - Payruns - Wage image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://nmbrs.stoplight.io/docs/nmbrs-restapi baseURL: https://api.nmbrsapp.com properties: - url: https://developer.nmbrs.com/docs type: Documentation - url: https://nmbrs.stoplight.io/docs/nmbrs-restapi type: APIReference - url: openapi/nmbrs-openapi.yml type: OpenAPI - url: collections/nmbrs.postman_collection.json type: PostmanCollection - url: collections/nmbrs.opencollection.json type: OpenCollection description: >- Payroll data - list a company's payruns (per period/year) and read employee salaries - the engine behind Nmbrs per-payslip billing. Salary access is guarded by the employee.payment scope. Endpoints modeled from documented resource groups (endpointsModeled). - aid: nmbrs:nmbrs-wage-components-api name: Nmbrs Wage Components API tags: - Payroll - Wage Components - Compensation image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://nmbrs.stoplight.io/docs/nmbrs-restapi baseURL: https://api.nmbrsapp.com properties: - url: https://developer.nmbrs.com/docs type: Documentation - url: https://nmbrs.stoplight.io/docs/nmbrs-restapi type: APIReference - url: openapi/nmbrs-openapi.yml type: OpenAPI - url: collections/nmbrs.postman_collection.json type: PostmanCollection - url: collections/nmbrs.opencollection.json type: OpenCollection description: >- Fixed and variable wage components applied to an employee in payroll - list existing components and add new ones per period/year. Modeled from the documented wage-component resource group and the SOAP WageComponentFixed/WageComponentVar operations (endpointsModeled). - aid: nmbrs:nmbrs-absences-api name: Nmbrs Absences API tags: - Human Resources - Absence Management - Leave image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://nmbrs.stoplight.io/docs/nmbrs-restapi baseURL: https://api.nmbrsapp.com properties: - url: https://developer.nmbrs.com/docs type: Documentation - url: https://nmbrs.stoplight.io/docs/nmbrs-restapi type: APIReference - url: openapi/nmbrs-openapi.yml type: OpenAPI - url: collections/nmbrs.postman_collection.json type: PostmanCollection - url: collections/nmbrs.opencollection.json type: OpenCollection description: >- Employee absence, leave, and sickness registrations - list existing records and register new absences. Modeled from the documented absence resource group and the SOAP Absence2 operations (endpointsModeled). - aid: nmbrs:nmbrs-soap-employee-service name: Nmbrs SOAP EmployeeService (Legacy) tags: - SOAP - HRIS - Legacy image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://api.nmbrs.nl/soap/v3/EmployeeService.asmx baseURL: https://api.nmbrs.nl/soap/v3 properties: - url: https://support.nmbrs.nl/hc/nl/articles/205903718-Nmbrs-API-for-developers type: Documentation - url: https://api.nmbrs.nl/soap/v3/EmployeeService.asmx type: APIReference - url: https://api.nmbrs.nl/soap/v3/EmployeeService.asmx?WSDL type: WSDL description: >- Legacy SOAP v3 EmployeeService (300+ operations, e.g. Employee_GetCurrent, Contract_GetAll, Salary_GetCurrent, Absence2_Insert, WageComponentFixed_Insert) authenticated with a username + API token. Deprecated - Nmbrs SOAP API is scheduled to be retired on 1 March 2027; migrate to the REST API. - aid: nmbrs:nmbrs-soap-company-service name: Nmbrs SOAP CompanyService (Legacy) tags: - SOAP - Payroll - Legacy image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://api.nmbrs.nl/soap/v3/CompanyService.asmx baseURL: https://api.nmbrs.nl/soap/v3 properties: - url: https://support.nmbrs.nl/hc/nl/articles/205903718-Nmbrs-API-for-developers type: Documentation - url: https://api.nmbrs.nl/soap/v3/CompanyService.asmx type: APIReference - url: https://api.nmbrs.nl/soap/v3/CompanyService.asmx?WSDL type: WSDL description: >- Legacy SOAP v3 CompanyService (120+ operations, e.g. Company_GetCurrentPeriod, Run_GetList, RunRequest_Insert, SalaryDocuments_GetAllPayslipsPDFByRunCompany, Journals_GetByRunCompany, WageTax_GetList) for company-level payroll, journals, and payslip documents. Deprecated - retiring 1 March 2027. - aid: nmbrs:nmbrs-soap-debtor-service name: Nmbrs SOAP DebtorService (Legacy) tags: - SOAP - Debtors - Legacy image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://api.nmbrs.nl/soap/v3/DebtorService.asmx baseURL: https://api.nmbrs.nl/soap/v3 properties: - url: https://support.nmbrs.nl/hc/nl/articles/205903718-Nmbrs-API-for-developers type: Documentation - url: https://api.nmbrs.nl/soap/v3/DebtorService.asmx type: APIReference - url: https://api.nmbrs.nl/soap/v3/DebtorService.asmx?WSDL type: WSDL description: >- Legacy SOAP v3 DebtorService for the accountant/debtor tier that owns companies (e.g. AccountantContact_GetList, Debtor_GetList). Deprecated - retiring 1 March 2027 in favor of the REST API. common: - type: AgenticAccess url: agentic-access/nmbrs-agentic-access.yml - type: Authentication url: authentication/nmbrs-authentication.yml - type: DomainSecurity url: security/nmbrs-domain-security.yml - type: LinkedIn url: https://www.linkedin.com/company/nmbrs - type: Website url: https://www.nmbrs.com - type: Documentation url: https://developer.nmbrs.com/docs - type: APIReference url: https://nmbrs.stoplight.io/docs/nmbrs-restapi - type: SignUp url: https://developer.nmbrs.com - type: Plans url: plans/nmbrs-plans-pricing.yml - type: RateLimits url: rate-limits/nmbrs-rate-limits.yml - type: FinOps url: finops/nmbrs-finops.yml - url: https://www.nmbrs.com/blog type: Blog maintainers: - FN: Kin Lane email: kin@apievangelist.com