Expense report fields - update

Recomputes the field definitions after a client-side change to one or more fields on an expense report. Send the current fields payload as the request body — typically after a field marked requiresUpdate: true was edited — and the response returns the same shape with derived and dependent fields refreshed. If the body’s id field carries an existing expense-report id the server uses it to load report context; otherwise the body alone is the source of truth. Unlike the GET variant, no fields are seeded from server-side records.

PUT

organizations

{id}

expensereports

fields

Expense report fields - update

curl --request PUT \
  --url https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensereports/fields \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensereports/fields"

headers = {"Authorization": "Bearer <token>"}

response = requests.put(url, headers=headers)

print(response.text)

const options = {method: 'PUT', headers: {Authorization: 'Bearer <token>'}};

fetch('https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensereports/fields', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensereports/fields",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensereports/fields"

	req, _ := http.NewRequest("PUT", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensereports/fields")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "fields": [
    {
      "name": "Id",
      "property": "id",
      "controlType": "TEXT",
      "mandatory": false,
      "visible": false,
      "value": "2bb9fcae93894bf7aa2e8f9009b8f3e2",
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Name",
      "property": "name",
      "controlType": "TEXT",
      "mandatory": false,
      "visible": true,
      "value": "Example Report Name",
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Description",
      "property": "description",
      "controlType": "MULTI_LINE_TEXT",
      "mandatory": false,
      "visible": true,
      "value": "Example expense report description",
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Recipients",
      "property": "recipientList",
      "controlType": "RECIPIENT_LIST",
      "mandatory": false,
      "visible": false,
      "value": [
        {
          "email": "test.user@findity.com"
        }
      ],
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Preview",
      "property": "previewURL",
      "controlType": "URL",
      "mandatory": false,
      "visible": true,
      "value": "https://expense.findity.com/api/expensereports/2bb9fcae93894bf7aa2e8f9009b8f3e2",
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Testlista rapport",
      "property": "8ab28c4e833655d4018336d471cf0134",
      "controlType": "LIST",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": true,
      "url": "/me/organizations/8a49a1b359cbfe2a0159d551c8d5008b/lists/CUSTOM_DIMENSIONS_a6e123ed4ab64d4c85d39dc50395c46f_8a49a1b359cbfe2a0159d551c8d5008b"
    },
    {
      "name": "FEP-1021 Test",
      "property": "8ab28c4f746e90720174718de8460504",
      "controlType": "LIST",
      "mandatory": false,
      "visible": false,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": true,
      "url": "/me/organizations/8a49a1b359cbfe2a0159d551c8d5008b/lists/CUSTOM_DIMENSIONS_81f165ee1f2244e793568e039acb826b_8a49a1b359cbfe2a0159d551c8d5008b"
    },
    {
      "name": "Expense records list",
      "property": "expenseRecords",
      "controlType": "LIST",
      "multiSelect": true,
      "mandatory": false,
      "visible": true,
      "value": [
        "28897169ff6444c6957f362812fb9cc8",
        "c99a0ead61344fa48657e8814737a524"
      ],
      "errorText": null,
      "error": null,
      "custom": false,
      "url": "/expenses?organizationId=8ab28c4f6fd37d39016fd6fee0470003&expenseReportId=0ac52a615656427689a2e5d6641e6bf0&include=meta.abbreviation"
    }
  ],
  "meta": {
    "capabilities": {
      "canBeDeleted": true,
      "canBeSentIn": false,
      "canBeRetracted": false
    },
    "summary": null
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

The id of the organization of the user UUID without dashes (32-character hex string)

Pattern: ^[0-9a-fA-F]{32}$

Query Parameters

include

enum<string>[]

optional properties to include

Available options:

meta.capabilities,

meta.summary

Response

Fields format of expense report

meta

object

Field-builder metadata for the expense report. Contains the summary, the caller's capability flags, and a preview URL.

Hide child attributes

meta.summary

object[]

Contains summarised information about report

Hide child attributes

meta.summary.property

string

Name of property

meta.summary.type

string

One of the following types will be provided [property_type, header, separator, image]

meta.summary.value

string

Value assigned to the property

meta.capabilities

object

Hide child attributes

meta.capabilities.canBeDeleted

boolean

Indicates if the expense report could be deleted or not

Example:

true

meta.capabilities.canBeRetracted

boolean

Indicates if the expense report can be retracted. A report can only be retracted if it is in APPROVAL status and no expense records or approval chain instances have been approved yet

Example:

false

meta.capabilities.canBeSentIn

boolean

Indicates if the expense report can be sent in by end user

Example:

true

meta.capabilities.canBeEdited

boolean

Indicates if the expense report can be edited in by end user

Example:

true

meta.capabilities.canRemoveExpenses

boolean

Indicates if expense records that are attached to/included in the report can be removed. This is set to false if the report is in processStatus = REJECTED or if it is corporate card expense report

meta.capabilities.canAddExpenses

boolean

Indicates if expense records that are not attached to/excluded from the report can be added. This is set to false if the report is in processStatus = REJECTED or if it is corporate card expense report

meta.previewUrl

string

delivers the URL that can be used for the preview of expense report

fields

object[]

Field-builder array describing the expense report's editable values. Each entry pairs a property name with a value and any errors.

Hide child attributes

fields.name

string

A translated name of the field, can be used to present to to the user

fields.property

string

Identifier of the field. Contains the path to the property in the expense API, for example verification.amount, cardLiability

fields.controlType

enum<string>

Available options:

TEXT,

MULTI_LINE_TEXT,

DOUBLE,

INTEGER,

SWITCH,

DATE,

DATE_TIME,

LIST,

CONTENT_HOLDER,

GUEST_LIST,

FIELD_GROUP,

LOCAL_DATE_TIME,

INFORMATION

fields.mandatory

boolean

The field is required

fields.visible

boolean

Only fields with visible = true should be shown

fields.requiresUpdate

boolean

Tells the client that if this field is changed, the client must call the API again with the fields data

fields.url

string

If controlType is LIST this property contains an url to the selectable values for this field

fields.custom

boolean

Indicates if this is a custom field not part of the standard fields

fields.scannable

boolean

Indicates if this field is part of the data extracted by the receipt scanning

fields.qrCodeSupported

boolean

Set on the verification.receiptAttachment (CONTENT_HOLDER) field when the organization's booking country uses fiscal QR codes on receipts (currently Portugal). When true, clients should offer a QR-scan step in the receipt capture flow and, on success, send the decoded string as the qrScan header on POST /content. Absent when not applicable.

fields.value

object

The value of the field, this is dynamic based on the control type. For example if the control type is DOUBLE the value property must have a double type. For SubsistenceAllowance and property = verification.specification[x].date1 or date2, this value is set/delivered in format "yyyy-MM-dd HH:mm" where the date is at UTC date time

fields.data

object

When calling the fields-endpoint initially, this may contain a list object for fields with control type LIST. This way the client does not have to make a call to the list endpoint to fetch the value. This has the same structure as the result in the list.

Hide child attributes

fields.data.id

string

Represents the id of the value that is set in this Field

fields.data.name

string

Representable text for chosen list item for set id

fields.data.section

integer

fields.data.iconUrl

string

fields.allowFutureDate

boolean

If controlType is DATE or DATE_TIME or LOCAL_DATE_TIME, this property is set. Default value is false. If the value is false, then date picker shouldn't allow setting date to value higher than today's date.

fields.error

string

A string that represents the error. This property is not empty when there is some error related to the specific field.

fields.errorText

string

Human readable description of value returned in error property. This property is not empty when there is some error related to the specific field.

fields.disabled

boolean

Indicates if property should be enabled or disabled for editing. In Approval flow, this property is always set to "true".

fields.fields

array

This property is populated when controlType="FIELD_GROUP" and it has the same structure as this array of objects. The list of objects represents all fields that are related to the specific field group.

fields.deletable

boolean

This property is used for removable fields, for example on the FIELD_GROUP for a specification in allowance

fields.deleteCommand

object

This property is used to define the command available on the filed of controlType=FIELD_GROUP

Hide child attributes

fields.deleteCommand.text

string

This property contains the text for the command to be displayed

fields.deleteCommand.confirmationRequired

boolean

This property indicates if the client should display a dialog with confirmation as result of it

fields.deleteCommand.confirmation

string

This property contains the text that should be displayed in case that confirmationRequired=true and client decided to perform the command/action

fields.deleteCommand.command

string

This property contains the command that can be executed by performing the PUT request with it on the fields endpoint

fields.informationType

enum<string>

This property is set when controlType=INFORMATION and it should indicate which type of information the field is

Available options:

normal,

information,

warning,

error,

success

fields.dismissible

boolean

This property is set when controlType=INFORMATION to indicate if the information is dismissible or not

fields.multiSelect

boolean

This property is going in combination with controlType=LIST to indicate that multiple values can be selected from the list

fields.listItemType

string

This property is set when there is controlType=LIST & multiSelect=true to indicate which type of item is list made of

fields.accessorIconUrl

string

This property is set by the URL value for the icon which can indicate access to different provided commands. It is usually provided within the field of controlType=FIELD_GROUP

fields.accessorText

string

This property represents the text that can be set as replacement for all the fields behind the defined FIELD_GROUP. It can be used as display for accessor to the list of the fields provided in the FIELD_GORUP

fields.numberOfDecimals

integer

The maximum number of decimals this field can present, uses current currency. only set for fields with an amount in value.

fields.summary

object[]

Contains summarised information about report

Hide child attributes

fields.summary.property

string

Name of property

fields.summary.type

string

One of the following types will be provided [property_type, header, separator, image]

fields.summary.value

string

Value assigned to the property

fields.commands

object[]

This property contains the list of possible commands that can be performed on the specific field

Hide child attributes

fields.commands.text

string

This property contains the text for the command to be displayed

fields.commands.confirmationRequired

boolean

This property indicates if the client should display a dialog with confirmation as result of it

fields.commands.confirmation

string

This property contains the text that should be displayed in case that confirmationRequired=true and client decided to perform the command/action

fields.commands.command

string

This property contains the command that can be executed by performing the PUT request with it on the fields endpoint

Last modified on August 31, 2026

⌘I

Expense report fields - update

curl --request PUT \
  --url https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensereports/fields \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensereports/fields"

headers = {"Authorization": "Bearer <token>"}

response = requests.put(url, headers=headers)

print(response.text)

const options = {method: 'PUT', headers: {Authorization: 'Bearer <token>'}};

fetch('https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensereports/fields', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensereports/fields",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensereports/fields"

	req, _ := http.NewRequest("PUT", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensereports/fields")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "fields": [
    {
      "name": "Id",
      "property": "id",
      "controlType": "TEXT",
      "mandatory": false,
      "visible": false,
      "value": "2bb9fcae93894bf7aa2e8f9009b8f3e2",
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Name",
      "property": "name",
      "controlType": "TEXT",
      "mandatory": false,
      "visible": true,
      "value": "Example Report Name",
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Description",
      "property": "description",
      "controlType": "MULTI_LINE_TEXT",
      "mandatory": false,
      "visible": true,
      "value": "Example expense report description",
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Recipients",
      "property": "recipientList",
      "controlType": "RECIPIENT_LIST",
      "mandatory": false,
      "visible": false,
      "value": [
        {
          "email": "test.user@findity.com"
        }
      ],
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Preview",
      "property": "previewURL",
      "controlType": "URL",
      "mandatory": false,
      "visible": true,
      "value": "https://expense.findity.com/api/expensereports/2bb9fcae93894bf7aa2e8f9009b8f3e2",
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Testlista rapport",
      "property": "8ab28c4e833655d4018336d471cf0134",
      "controlType": "LIST",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": true,
      "url": "/me/organizations/8a49a1b359cbfe2a0159d551c8d5008b/lists/CUSTOM_DIMENSIONS_a6e123ed4ab64d4c85d39dc50395c46f_8a49a1b359cbfe2a0159d551c8d5008b"
    },
    {
      "name": "FEP-1021 Test",
      "property": "8ab28c4f746e90720174718de8460504",
      "controlType": "LIST",
      "mandatory": false,
      "visible": false,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": true,
      "url": "/me/organizations/8a49a1b359cbfe2a0159d551c8d5008b/lists/CUSTOM_DIMENSIONS_81f165ee1f2244e793568e039acb826b_8a49a1b359cbfe2a0159d551c8d5008b"
    },
    {
      "name": "Expense records list",
      "property": "expenseRecords",
      "controlType": "LIST",
      "multiSelect": true,
      "mandatory": false,
      "visible": true,
      "value": [
        "28897169ff6444c6957f362812fb9cc8",
        "c99a0ead61344fa48657e8814737a524"
      ],
      "errorText": null,
      "error": null,
      "custom": false,
      "url": "/expenses?organizationId=8ab28c4f6fd37d39016fd6fee0470003&expenseReportId=0ac52a615656427689a2e5d6641e6bf0&include=meta.abbreviation"
    }
  ],
  "meta": {
    "capabilities": {
      "canBeDeleted": true,
      "canBeSentIn": false,
      "canBeRetracted": false
    },
    "summary": null
  }
}

Authentication

Findity Expense API

Findity Admin API

Findity Connect API

Expense report fields - update

Authorizations

Path Parameters

Query Parameters

Response