Nedap

Nedap Payroll.Contract API

The payroll.Contract API from Nedap — 10 operation(s) for payroll.contract.

Documentation GitHub OpenAPI

Operations 12

POST /t/payroll/contracts Create a new Contract #

GET /t/payroll/contracts/{id} Return the Contract corresponding to the given id #

PUT /t/payroll/contracts/{id} Update an existing Contract #

GET /t/employees/{employee_id}/contracts Return the contracts of an Employee corresponding to the given id #

GET /t/payroll/contracts/x-stream-connect/data Return all Contract models in a streaming manner #

GET /t/payroll/contracts/x-stream-connect/updates Return all Contract models which where updated since the date given in the… #

POST /v0/administration/contracts Create a new Contract #

GET /v0/administration/contracts/{id} Return the Contract corresponding to the given id #

PUT /v0/administration/contracts/{id} Update an existing Contract #

GET /v0/administration/employees/{employee_id}/contracts Return the contracts of an Employee corresponding to the given id #

GET /v0/xstream/contracts/data Return all Contract models in a streaming manner #

GET /v0/xstream/contracts/updates Return all Contract models which where updated since the date given in the… #

Documentation

📖

Documentation

https://ons-api.nl/english/english.html

📖

APIReference

https://ons-api.nl/english/technical/APIS.html

📖

GettingStarted

https://ons-api.nl/english/integration_process/Integration_process.html

📖

Authentication

https://ons-api.nl/english/technical/Certificate_requirements.html

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/nedap/refs/heads/main/openapi/nedap-payroll-contract-api-openapi.yml

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/nedap-payroll-contract-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Nedap Payroll.Contract API
  version: 0.0.0
  description: 'Operations tagged payroll.Contract across 2 of this provider''s published API definitions: nedap-ons-deprecated-openapi-original.json, nedap-ons-openapi-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api-development.ons.io
tags:
- name: payroll.Contract
paths:
  /t/payroll/contracts:
    post:
      tags:
      - payroll.Contract
      summary: Create a new Contract
      operationId: payroll.ContractAPI.create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/payroll.Contract'
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payroll.Contract'
        '400':
          description: Validation errors
      x-cupido-common-method: true
      x-replaced-by: /v0/administration/contracts
      deprecated: true
      x-deprecated-since: 19-11-2025
    servers:
    - url: https://api-development.ons.io
  /t/payroll/contracts/{id}:
    get:
      tags:
      - payroll.Contract
      summary: Return the Contract corresponding to the given id
      operationId: payroll.ContractAPI.byId
      parameters:
      - name: id
        in: path
        description: used for selecting Contract
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: No response was specified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payroll.Contract'
        '404':
          description: Contract not found
      x-cupido-common-method: true
      x-replaced-by: /v0/administration/contracts/{id}
      deprecated: true
      x-deprecated-since: 19-11-2025
    put:
      tags:
      - payroll.Contract
      summary: Update an existing Contract
      operationId: payroll.ContractAPI.update
      parameters:
      - name: id
        in: path
        description: used for selecting Contract
        required: true
        schema:
          type: integer
          format: int64
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/payroll.Contract'
        required: true
      responses:
        '200':
          description: No response was specified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payroll.Contract'
        '400':
          description: Validation errors
        '404':
          description: Contract not found
      x-cupido-common-method: true
      x-replaced-by: /v0/administration/contracts/{id}
      deprecated: true
      x-deprecated-since: 19-11-2025
    servers:
    - url: https://api-development.ons.io
  /t/employees/{employee_id}/contracts:
    get:
      tags:
      - payroll.Contract
      summary: Return the contracts of an Employee corresponding to the given id
      operationId: payroll.ContractAPI.byEmployeeId
      parameters:
      - name: employee_id
        in: path
        description: id
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: No response was specified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payroll.list.ContractList'
      x-replaced-by: /v0/administration/employees/{employee_id}/contracts
      deprecated: true
      x-deprecated-since: 19-11-2025
    servers:
    - url: https://api-development.ons.io
  /t/payroll/contracts/x-stream-connect/data:
    get:
      tags:
      - payroll.Contract
      summary: Return all Contract models in a streaming manner
      operationId: payroll.ContractAPI.streamAll
      responses:
        '200':
          description: No response was specified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payroll.list.ContractList'
            application/x-ndjson:
              schema:
                $ref: '#/components/schemas/payroll.Contract'
        '400':
          description: Could not parse request parameter
        '404':
          description: Resource not found
        '500':
          description: Unspecified internal error
      x-cupido-common-method: true
      x-replaced-by: /v0/xstream/contracts/data
      deprecated: true
      x-deprecated-since: 19-11-2025
    servers:
    - url: https://api-development.ons.io
  /t/payroll/contracts/x-stream-connect/updates:
    get:
      tags:
      - payroll.Contract
      summary: Return all Contract models which where updated since the date given in the…
      operationId: payroll.ContractAPI.streamUpdates
      parameters:
      - name: since
        in: query
        required: true
        schema:
          type: string
          format: date-time
        example: '2014-12-29T00:00:00.000'
      responses:
        '200':
          description: No response was specified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payroll.list.ContractList'
            application/x-ndjson:
              schema:
                $ref: '#/components/schemas/payroll.Contract'
        '400':
          description: Could not parse request parameter
        '404':
          description: Resource not found
        '500':
          description: Unspecified internal error
      x-cupido-common-method: true
      x-replaced-by: /v0/xstream/contracts/updates
      deprecated: true
      x-deprecated-since: 19-11-2025
    servers:
    - url: https://api-development.ons.io
  /v0/administration/contracts:
    post:
      tags:
      - payroll.Contract
      summary: Create a new Contract
      operationId: payroll.ContractAPI.create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/payroll.Contract'
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payroll.Contract'
        '400':
          description: Validation errors
      x-cupido-common-method: true
      x-replacement-for:
      - /t/payroll/contracts
    servers:
    - url: https://api-development.ons.io
  /v0/administration/contracts/{id}:
    get:
      tags:
      - payroll.Contract
      summary: Return the Contract corresponding to the given id
      operationId: payroll.ContractAPI.byId
      parameters:
      - name: id
        in: path
        description: used for selecting Contract
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: No response was specified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payroll.Contract'
        '404':
          description: Contract not found
      x-cupido-common-method: true
      x-replacement-for:
      - /t/payroll/contracts/{id}
    put:
      tags:
      - payroll.Contract
      summary: Update an existing Contract
      operationId: payroll.ContractAPI.update
      parameters:
      - name: id
        in: path
        description: used for selecting Contract
        required: true
        schema:
          type: integer
          format: int64
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/payroll.Contract'
        required: true
      responses:
        '200':
          description: No response was specified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payroll.Contract'
        '400':
          description: Validation errors
        '404':
          description: Contract not found
      x-cupido-common-method: true
      x-replacement-for:
      - /t/payroll/contracts/{id}
    servers:
    - url: https://api-development.ons.io
  /v0/administration/employees/{employee_id}/contracts:
    get:
      tags:
      - payroll.Contract
      summary: Return the contracts of an Employee corresponding to the given id
      operationId: payroll.ContractAPI.byEmployeeId
      parameters:
      - name: employee_id
        in: path
        description: id
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: No response was specified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payroll.list.ContractList'
      x-replacement-for:
      - /t/employees/{employee_id}/contracts
    servers:
    - url: https://api-development.ons.io
  /v0/xstream/contracts/data:
    get:
      tags:
      - payroll.Contract
      summary: Return all Contract models in a streaming manner
      operationId: payroll.ContractAPI.streamAll
      responses:
        '200':
          description: No response was specified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payroll.list.ContractList'
            application/x-ndjson:
              schema:
                $ref: '#/components/schemas/payroll.Contract'
        '400':
          description: Could not parse request parameter
        '404':
          description: Resource not found
        '500':
          description: Unspecified internal error
      x-cupido-common-method: true
      x-replacement-for:
      - /t/payroll/contracts/x-stream-connect/data
    servers:
    - url: https://api-development.ons.io
  /v0/xstream/contracts/updates:
    get:
      tags:
      - payroll.Contract
      summary: Return all Contract models which where updated since the date given in the…
      operationId: payroll.ContractAPI.streamUpdates
      parameters:
      - name: since
        in: query
        required: true
        schema:
          type: string
          format: date-time
        example: '2014-12-29T00:00:00.000'
      responses:
        '200':
          description: No response was specified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/payroll.list.ContractList'
            application/x-ndjson:
              schema:
                $ref: '#/components/schemas/payroll.Contract'
        '400':
          description: Could not parse request parameter
        '404':
          description: Resource not found
        '500':
          description: Unspecified internal error
      x-cupido-common-method: true
      x-replacement-for:
      - /t/payroll/contracts/x-stream-connect/updates
    servers:
    - url: https://api-development.ons.io
components:
  schemas:
    payroll.Contract:
      type: object
      properties:
        id:
          type: integer
          format: int64
          x-cupido-id: true
        employeeId:
          type: integer
          format: int64
        fixed:
          type: number
          format: double
        var:
          type: number
          format: double
        contractTypeId:
          type: integer
          format: int64
        beginDate:
          type: string
          format: date
        endDate:
          type: string
          format: date
      description: 'Contract model


        Created on 22/04/15.'
      example:
        id: 1
        employeeId: 1
        fixed: 1.234
        var: 1.234
        contractTypeId: 1
        beginDate: '2015-01-01'
        endDate: '2020-01-01'
      xml:
        name: contract
    payroll.list.ContractList:
      type: object
      properties:
        contracts:
          type: array
          items:
            $ref: '#/components/schemas/payroll.Contract'
          xml:
            name: contract
      description: ContractList model (no description)
      example:
        contracts:
        - id: 1
          employeeId: 1
          fixed: 1.234
          var: 1.234
          contractTypeId: 1
          beginDate: '2015-01-01'
          endDate: '2020-01-01'
      xml:
        name: contracts
x-refined-from:
- nedap-ons-deprecated-openapi-original.json
- nedap-ons-openapi-original.json