VismaBouwsoftAPICalls.v1_GET_ActualCostProducts Method
v1_GET_ActualCostProducts() as String

This API call is used to get fields of a(n) ActualCostProduct(s)

HTTP method API version
GET v1

Don’t forget to put the Authorization field in the header

API Path: /ActualCostProducts/
or
API Path: /ActualCostProducts/{id}
or
API Path: /ActualCostProducts/FieldInfo/

You can make this API call:
* without the key field id to get a list of ActualCostProducts
* with the key field id as the path parameter (the specific id of the ActualCostProduct you want to get)
* to request the FieldInfo for this call

Fields

The following fields are available:

Field Name Type Id Type Name Length Required Writeable Force Write Link
project_id 1 tpLong 0 No Yes No
project_pnr 1 tpLong 0 No No No
project_unr 1 tpLong 0 No No No
project_name 2 tpString 100 No No No
actualcostitem_id 1 tpLong 0 No Yes No
actualcostitem_nr1 2 tpString 100 No No No
actualcostitem_nr2 2 tpString 100 No No No
actualcostitem_description 2 tpString 0 No No No
actualcostitem_description_localized 2 tpString 0 No No No
employee_id 1 tpLong 0 No Yes No
employee_name 2 tpString 150 No No No
date 3 tpDate 0 No Yes No
job_id 1 tpLong 0 No Yes No
job_code 2 tpString 10 No No No
job_name 2 tpString 100 No No No
product_id 1 tpLong 0 No Yes No
nr 2 tpString 100 No Yes No
description 2 tpString 0 No Yes No
quantity 4 tpDouble 0 No Yes No
unit 2 tpString 10 No Yes No
unit_localized 2 tpString 10 No No No
price_unit 8 tpCurrency 0 No Yes No
price_total_without_margin 8 tpCurrency 0 No No No
margin 4 tpDouble 0 No Yes No
price_total_with_margin 8 tpCurrency 0 No No No
working_on_time_and_expense_basis 5 tpBool 0 No Yes No
extra_work 5 tpBool 0 No Yes No
location 2 tpString 50 No Yes No
stocklocationid 1 tpLong 0 No Yes No
stocklocation 2 tpString 100 No No No
note 2 tpString 0 No Yes No
company_id 1 tpLong 0 No Yes No
invoiced 5 tpBool 0 No No No
check 5 tpBool 0 No No No
ts_lastupdate 3 tpDate 0 No No No

/ActualCostProducts/

API Path: /ActualCostProducts/

If everything succeeds the HTTP response status is 200
(200 OK)

If there is something wrong with the request, the response status and code is 400
(400 Bad Request)

If you forget to send the Authorization, the response status is 401
(401 Unauthorized)

If what you sent can’t be processed, the response status is 500
(500 Internal Server Error)

For an explanation of all possible errors, please consult our section on possible answers to API calls here

Examples:

https://ra.bouwsoft.be/api/v1/ActualCostProducts

with the following parameters :

Header Parameters :
ParameterName: AccessToken, ParameterValue: OlGfWxflfVzSffmODtzRqjjIfmVVIOtGjmGtzDtbAGfGDVIVlD
ParameterName: Clientnr, ParameterValue: 115

Query Parameters :
ParameterName: limit, ParameterValue: 5
ParameterName: sort, ParameterValue: id

Success gives statuscode 200 And the following result

{ “Content-Range”:“0–4/3835”, “Records”: [
  {
    "id": 2,
    "project_id": 3,
    "project_pnr": 20120003,
    "project_unr": 3,
    "project_name": "Project Parketvloeren 2016",
    "actualcostitem_id": 4,
    "actualcostitem_nr1": "P.00.01a",
    "actualcostitem_nr2": "",
    "actualcostitem_description": "Plaatsing parket dmv verlijming: European Oak: inkom",
    "actualcostitem_description_localized": "Plaatsing parket dmv verlijming: European Oak: inkom",
    "employee_id": 0,
    "employee_name": "",
    "date": "2012–03–21",
    "job_id": 4,
    "job_code": "04",
    "job_name": "PLAATSING04",
    "product_id": 7,
    "nr": "249",
    "description": "249 Express Elastische parketlijm",
    "quantity": 380,
    "unit": "kg",
    "unit_localized": "kg",
    "price_unit": 10.0,
    "price_total_without_margin": 3800.0,
    "margin": 0,
    "price_total_with_margin": 3800.0,
    "working_on_time_and_expense_basis": false,
    "extra_work": false,
    "location": "Werf",
    "stocklocationid": 4,
    "stocklocation": "Depot 1",
    "note": "",
    "company_id": 1,
    "invoiced": true,
    "check": false,
    "ts_lastupdate": "2026–02–22 11:50:09"
  },
  {
    "id": 3,
    "project_id": 8,
    "project_pnr": 20120005,
    "project_unr": 5,
    "project_name": "Binnendeuren",
    "actualcostitem_id": 13,
    "actualcostitem_nr1": "BD GL 01",
    "actualcostitem_nr2": "",
    "actualcostitem_description": "Schuifdeur in glas \"Thytan Mat\" Afm. : H.215cm x L.93cm",
    "actualcostitem_description_localized": "Schuifdeur in glas \"Thytan Mat\" Afm. : H.215cm x L.93cm",
    "employee_id": 0,
    "employee_name": "",
    "date": "2012–04–17",
    "job_id": 0,
    "job_code": "",
    "job_name": "",
    "product_id": 17,
    "nr": "DG002",
    "description": "Schuifdeur in glas \"Thytan Mat\"\r\nAfm. : H.215cm x L.93cm",
    "quantity": 380,
    "unit": "st.",
    "unit_localized": "pc.",
    "price_unit": 202.300000000000011,
    "price_total_without_margin": 76874.0,
    "margin": 50,
    "price_total_with_margin": 115311.0,
    "working_on_time_and_expense_basis": false,
    "extra_work": false,
    "location": "Werf",
    "stocklocationid": 0,
    "stocklocation": "",
    "note": "",
    "company_id": 1,
    "invoiced": true,
    "check": false,
    "ts_lastupdate": "2026–02–22 11:50:09"
  }
,

]
}

/ActualCostProducts/{id}

If everything succeeds the HTTP response status is 200
(200 OK)

If there is something wrong with the request, the response status and code is 400
(400 Bad Request)

If there is no record that has the requested id the HTTP response status and code is 404
(404 Not found)

If you forget to send the Authorization, the response status is 401
(401 Unauthorized)

If what you sent can’t be processed, the response status is 500
(500 Internal Server Error)

For an explanation of all possible errors, please consult our section on possible answers to API calls here

Examples:

https://ra.bouwsoft.be/api/v1/ActualCostProducts/6673

with the following parameters :

Header Parameters :
ParameterName: AccessToken, ParameterValue: rPGfWxfVkGzSfIGUDtzRqkbbfGPkIOAAjVItztOADtrGDfrPPD
ParameterName: Clientnr, ParameterValue: 115

Success gives statuscode 200 And the following result

{ “Content-Range”:“0–0/1”, “Records”: [
  {
    "id": 6673,
    "project_id": 3320,
    "project_pnr": 2021060078,
    "project_unr": 1275,
    "project_name": "Schilderen van API blokjes",
    "actualcostitem_id": 2865,
    "actualcostitem_nr1": "",
    "actualcostitem_nr2": "",
    "actualcostitem_description": "Volledig Project",
    "actualcostitem_description_localized": "Complete project",
    "employee_id": 0,
    "employee_name": "",
    "date": "2026–05–07",
    "job_id": 0,
    "job_code": "",
    "job_name": "",
    "product_id": 2832401,
    "nr": "457",
    "description": "Baksteen",
    "quantity": 10,
    "unit": "st.",
    "unit_localized": "pc.",
    "price_unit": 12.35,
    "price_total_without_margin": 123.5,
    "margin": 20,
    "price_total_with_margin": 148.199999999999989,
    "working_on_time_and_expense_basis": false,
    "extra_work": false,
    "location": "Werf",
    "stocklocationid": 0,
    "stocklocation": "",
    "note": "",
    "company_id": 1,
    "invoiced": false,
    "check": false,
    "ts_lastupdate": "2026–05–07 09:19:56"
  }
]
}

/ActualCostProducts/FieldInfo

If everything succeeds the HTTP response status is 200
(200 OK)

If there is something wrong with the request, the response status and code is 400
(400 Bad Request)

If there is no record that has the requested id the HTTP response status and code is 404
(404 Not found)

If you forget to send the Authorization, the response status is 401
(401 Unauthorized)

If what you sent can’t be processed, the response status is 500
(500 Internal Server Error)

For an explanation of all possible errors, please consult our section on possible answers to API calls here

Examples:

https://ra.bouwsoft.be/api/v1/ActualCostProducts/FieldInfo

with the following parameters :

Header Parameters :
ParameterName: AccessToken, ParameterValue: ffjfWxfODjzSfPGtOtzRqUUUfkGUIOrmjIAtzOttOjVGrUAkrO
ParameterName: Clientnr, ParameterValue: 115

Success gives statuscode 200 And the following result

[
  {
    "name": "project_id",
    "type_id": 1,
    "type_name": "tpLong",
    "length": 0,
    "required": false,
    "writeable": true,
    "forcewrite": false,
    "link": ""
  },
  {
    "name": "project_pnr",
    "type_id": 1,
    "type_name": "tpLong",
    "length": 0,
    "required": false,
    "writeable": false,
    "forcewrite": false,
    "link": ""
  }
,

]