Expense type fields - initialize

Returns the field definitions needed to render a form for creating or editing an expense record of the given expenseType. The shape of fields varies by type (ReceiptVerification, CarSpecification, SubsistenceAllowance, FoodBenefitsSpecification, FuelBenefitsSpecification) — for example, ReceiptVerification surfaces amount and receipt-attachment fields, CarSpecification surfaces distance and route fields, and SubsistenceAllowance surfaces day-by-day per-diem fields. Initial values can be seeded from an existing expense record (pass expenseRecordId), from a card transaction (pass cardTransactionId), from a receipt inbox item, i.e. a receipt email from the user’s connected inbox (pass inboxItemId, ReceiptVerification only), or from a business-trip / fuel-benefit context (pass fromFuelBenefit=true together with either businessTripId or fuelBenefitId); omit all of those to start from a blank record.

GET

organizations

{id}

expensetypes

{expenseType}

fields

Expense type fields - initialize

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

import requests

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

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

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

print(response.text)

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

fetch('https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensetypes/{expenseType}/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}/expensetypes/{expenseType}/fields",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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}/expensetypes/{expenseType}/fields"

	req, _ := http.NewRequest("GET", 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))

}

HttpResponse<String> response = Unirest.get("https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensetypes/{expenseType}/fields")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.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": "99601cd0f6ba438cb16ca17b8edf25a0",
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": null,
      "property": "version",
      "controlType": "INTEGER",
      "mandatory": false,
      "visible": false,
      "value": 2,
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Receipt",
      "property": "verification.receiptAttachment",
      "controlType": "CONTENT_HOLDER",
      "mandatory": false,
      "visible": true,
      "value": "receiptAttachmentId",
      "errorText": null,
      "error": null,
      "custom": false,
      "data": {
        "id": "receiptAttachmentId",
        "name": "name of receiptAttachment"
      }
    },
    {
      "name": "Category",
      "property": "categoryId",
      "controlType": "LIST",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false,
      "requiresUpdate": true,
      "scannable": true,
      "url": "/me/organizations/8ab28cb36ccde07d016ccdfb47d00216/expensetypes/ReceiptVerification/categories"
    },
    {
      "name": "Expense report",
      "property": "expenseReportId",
      "controlType": "LIST",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false,
      "url": "/expensereports?statuses=NORMAL,NEW&organizationId=8ab28cb36ccde07d016ccdfb47d00216"
    },
    {
      "name": "Verification number",
      "property": "verification.verificationNumber",
      "controlType": "TEXT",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false,
      "disabled": true
    },
    {
      "name": "Description",
      "property": "verification.description",
      "controlType": "TEXT",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Date of purchase",
      "property": "verification.purchaseDate",
      "controlType": "DATE",
      "mandatory": false,
      "visible": true,
      "value": "2019-09-30T14:33:26Z",
      "errorText": null,
      "error": null,
      "custom": false,
      "requiresUpdate": true,
      "scannable": true,
      "allowFutureDate": false
    },
    {
      "name": "Payment method",
      "property": "verification.paymentTypeId",
      "controlType": "LIST",
      "mandatory": true,
      "visible": true,
      "value": "f433bd56f038486faeee6a5ddd5177f2",
      "errorText": null,
      "error": null,
      "custom": false,
      "url": "/me/organizations/8ab28cb36ccde07d016ccdfb47d00216/paymenttypes",
      "data": {
        "iconUrl": null,
        "id": "f433bd56f038486faeee6a5ddd5177f2",
        "name": "Payment",
        "section": null
      }
    },
    {
      "name": "Store",
      "property": "verification.storeName",
      "controlType": "TEXT",
      "mandatory": false,
      "visible": false,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Amount incl. VAT",
      "property": "verification.amount",
      "controlType": "DOUBLE",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false,
      "scannable": true
    },
    {
      "name": "Tip",
      "property": "verification.tip",
      "controlType": "DOUBLE",
      "mandatory": false,
      "visible": false,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "VAT",
      "property": "verification.taxAmount",
      "controlType": "DOUBLE",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false,
      "scannable": true
    },
    {
      "name": "Currency",
      "property": "verification.currency",
      "controlType": "LIST",
      "mandatory": true,
      "visible": true,
      "value": "SEK",
      "errorText": null,
      "error": null,
      "custom": false,
      "requiresUpdate": true,
      "scannable": true,
      "url": "/me/organizations/8ab28cb36ccde07d016ccdfb47d00216/currencies",
      "data": {
        "iconUrl": null,
        "id": "SEK",
        "name": "Swedish Krona",
        "section": null
      }
    },
    {
      "name": "Exchange rate",
      "property": "verification.exchangeRate",
      "controlType": "DOUBLE",
      "mandatory": false,
      "visible": false,
      "value": 1,
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Expense Level (not-changable)",
      "property": "8ab28c4f70f773590170f7cda2ea08bc",
      "controlType": "LIST",
      "mandatory": false,
      "visible": false,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": true,
      "url": "/me/organizations/8ab28cb36ccde07d016ccdfb47d00216/lists/CUSTOM_DIMENSIONS_4f38a4cc3fe242d394058626523044c1_8ab28cb36ccde07d016ccdfb47d00216"
    },
    {
      "name": "Employee dim",
      "property": "8ab28c4f723887dd01723c5cae82020e",
      "controlType": "LIST",
      "mandatory": false,
      "visible": false,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": true,
      "url": "/me/organizations/8ab28cb36ccde07d016ccdfb47d00216/lists/CUSTOM_DIMENSIONS_d4c8684b75ff4026b69810c8d912aea4_8ab28cb36ccde07d016ccdfb47d00216"
    },
    {
      "name": "Entertainment",
      "property": "verification.representation",
      "controlType": "FIELD_GROUP",
      "mandatory": false,
      "visible": false,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false,
      "fields": [
        {
          "name": "Type",
          "property": "verification.representation.type",
          "controlType": "LIST",
          "mandatory": false,
          "visible": false,
          "value": null,
          "errorText": null,
          "error": null,
          "custom": false,
          "requiresUpdate": true
        },
        {
          "name": "Included liquor/wine/strong beer",
          "property": "verification.representation.includesLiquor",
          "controlType": "SWITCH",
          "mandatory": false,
          "visible": false,
          "value": null,
          "errorText": null,
          "error": null,
          "custom": false
        },
        {
          "name": "Attach guest list",
          "property": "verification.representation.guestListAttached",
          "controlType": "SWITCH",
          "mandatory": false,
          "visible": false,
          "value": false,
          "errorText": null,
          "error": null,
          "custom": false,
          "requiresUpdate": true
        },
        {
          "name": "Guests",
          "property": "verification.representation.guests",
          "controlType": "GUEST_LIST",
          "mandatory": false,
          "visible": false,
          "value": [],
          "errorText": null,
          "error": null,
          "custom": false
        },
        {
          "name": "Number of guests",
          "property": "verification.representation.numberOfGuests",
          "controlType": "INTEGER",
          "mandatory": false,
          "visible": false,
          "value": null,
          "errorText": null,
          "error": null,
          "custom": false
        },
        {
          "name": "Number of external guests",
          "property": "verification.representation.numberOfExternalGuests",
          "controlType": "INTEGER",
          "mandatory": false,
          "visible": false,
          "value": null,
          "errorText": null,
          "error": null,
          "custom": false
        },
        {
          "name": "Place",
          "property": "verification.representation.place",
          "controlType": "TEXT",
          "mandatory": false,
          "visible": false,
          "value": null,
          "errorText": null,
          "error": null,
          "custom": false
        },
        {
          "name": "Attached guest list",
          "property": "verification.representation.guestListAttachment",
          "controlType": "CONTENT_HOLDER",
          "mandatory": true,
          "visible": false,
          "value": "guestListAttachmentId",
          "errorText": null,
          "error": null,
          "custom": false,
          "data": {
            "id": "guestListAttachmentId",
            "name": "name of guestListAttachment"
          }
        }
      ],
      "commands": [
        {
          "text": "Clear guests",
          "confirmationRequired": true,
          "confirmation": "Are you sure you want to clear guests?",
          "command": "action=removeGuests"
        },
        {
          "text": "Clear representation",
          "confirmationRequired": true,
          "confirmation": "Are you sure you want to clear representation?",
          "command": "action=removeRepresentation"
        }
      ]
    },
    {
      "name": "Comment",
      "property": "verification.comment",
      "controlType": "MULTI_LINE_TEXT",
      "mandatory": false,
      "visible": true,
      "value": "Some comment",
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Card transaction",
      "property": "verification.cardTransaction",
      "controlType": "TEXT",
      "mandatory": false,
      "visible": true,
      "value": "Some id",
      "errorText": null,
      "error": null,
      "custom": false,
      "disabled": true
    },
    {
      "name": "Attachments",
      "property": "verification.attachments",
      "controlType": "CONTENT_HOLDER",
      "mandatory": false,
      "visible": true,
      "value": [
        "id1",
        "id2"
      ],
      "errorText": null,
      "error": null,
      "custom": false,
      "disabled": false,
      "data": [
        {
          "id": "id1",
          "name": "name of attachment with id1"
        },
        {
          "id": "id2",
          "name": "name of attachment with id2"
        }
      ]
    }
  ]
}

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}$

expenseType

enum<string>

required

Expense type where CarSpecification relates to Mileage, SubsistenceAllowance to Per Diem, etc

Available options:

CarSpecification,

FoodBenefitsSpecification,

FuelBenefitsSpecification,

ReceiptVerification,

SubsistenceAllowance

Query Parameters

expenseRecordId

string

The id of the expense to initialize the fields with UUID without dashes (32-character hex string)

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

include

enum<string>[]

optional properties to include

Available options:

meta.capabilities,

meta.summary,

summaries

cardTransactionId

string

The id of the card transaction to initialize the fields with UUID without dashes (32-character hex string)

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

inboxItemId

string<uuid>

The id of a receipt inbox item (a receipt email fetched from the user's connected email inbox) to initialize a new receipt with. The id comes from the Inbox Service and is a standard UUID with dashes, not a 32-character hex Findity id. Only valid for the ReceiptVerification expense type and only when creating a new expense, so it can not be combined with expenseRecordId, cardTransactionId or fromFuelBenefit. Requires the receipt inbox to be enabled for the organization. The amount, currency, purchase date and description are taken from the email, and the email's receipt attachment is attached and scanned. Each request downloads and scans the attachment again, so call this once and use the PUT variant for later updates. The created expense keeps no reference to the inbox item.

fromReport

boolean

used when creating an expenseRecord from a report

Response

Fields format of expense record

meta

object

read-only

Hide child attributes

meta.summary

Summary of the resource. May be null when the summary is not computed for the response.

Hide child attributes

meta.summary.type

enum<string>

Kind of row: property_value is a labelled value, separator divides groups of rows and has no property or value, and image shows the image referenced by value and has no property. Clients should tolerate other values.

Available options:

property_value,

separator,

image

meta.summary.property

string

Label of the row. Only present on property_value rows.

meta.summary.value

string

Display value of a property_value row, or the image reference of an image row. Omitted when there is no value.

meta.capabilities

object

What the caller may do with the resource. May be null when the capabilities are not computed for the response.

Option 1
Option 2

Hide child attributes

meta.capabilities.canBeAddedToReport

boolean

Indicates if the expense record can be added to a report

Example:

false

meta.capabilities.canBeRemovedFromReport

boolean

Indicates if the expense record can be removed from a report

Example:

false

meta.capabilities.canBeDeleted

boolean

Indicates if the expense record can be deleted

Example:

true

meta.capabilities.canBeSentIn

boolean

true if the expense record can be sent in directly without report

Example:

true

meta.capabilities.canBeSplit

boolean

Indicates if the expense record can be split

Example:

false

meta.capabilities.canBeEdited

boolean

Indicates if the expense record can be edited

Example:

true

meta.capabilities.canBeMerged

boolean

Indicates if the expense record can be merged with another expense record. Will only be true for expense records that are based on card transaction, has not been split and is editable by end user.

Example:

false

meta.capabilities.canAddBreakfast

boolean

ONLY PART OF FoodBenefitsSpecifications! Indicates if breakfast is available for meal benefits.

Example:

false

meta.capabilities.canAddLunch

boolean

ONLY PART OF FoodBenefitsSpecifications! Indicates if lunch is available for meal benefits.

Example:

false

meta.capabilities.canAddDinner

boolean

ONLY PART OF FoodBenefitsSpecifications! Indicates if dinner is available for meal benefits.

Example:

false

fields

object[]

Field-builder array describing the editable properties of the resource. Each entry pairs a property name with a value and any errors.

Hide child attributes

fields.name

string | null

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

fields.hint

string

A translated input hint (placeholder) for the field, for example "Enter first name" or "Select currency". Clients can show it in the empty input. Absent when the field has no hint, which is always the case for custom fields.

fields.property

string

Identifier of the field. Contains the path to the property in the expense API, for example verification.amount, cardLiability. Expense record and expense report fields include a hidden (visible: false) version field (controlType INTEGER) holding the optimistic-lock version of the stored object (null for a new object). Send it back unchanged in the fields of the update request; if the object has been modified since it was read, the update is rejected with 409 CONCURRENT_MODIFICATION.

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,

COMMAND,

MILEAGE_ROUTE,

MULTI_VALUE

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

any

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. For a multiSelect field it is an array of such objects. Absent when there is no data.

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 | null

fields.data.iconUrl

string | null

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 | null

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

fields.errorText

string | null

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 the resource, as rows to display in order

Hide child attributes

fields.summary.type

enum<string>

Available options:

property_value,

separator,

image

fields.summary.property

string

Label of the row. Only present on property_value rows.

fields.summary.value

string

Display value of a property_value row, or the image reference of an image row. Omitted when there is no value.

fields.commands

object[] | null

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

fields.clientCommand

object | null

Action the client performs itself when the field is activated, such as opening an edit dialog or a web view. Present (possibly null) on fields with controlType COMMAND or FIELD_GROUP; absent on other fields.

Hide child attributes

fields.clientCommand.clientAction

string

The client-side action to perform, e.g. editEmail, editPhone, openChangePassword, openWebView.

Example:

"editEmail"

fields.clientCommand.entityId

string

Id of the entity the action applies to. Omitted when not applicable.

fields.clientCommand.organizationId

string

Organization the action applies to. Omitted when not applicable.

fields.clientCommand.url

string

URL to open, for actions such as openWebView. Omitted when not applicable.

fields.clientCommand.isWebView

boolean

true when url should be opened in an in-app web view. Only present when true.

validationErrors

object[]

Response-only. Server-populated array of validation errors that apply to the resource as a whole (not tied to a specific field).

Hide child attributes

validationErrors.errorMessage

string

description provided for errorCode

validationErrors.errorCode

string

textual code of error

validationErrors.checkType

enum<string>

BLOCKER indicates that expense instance cannot be sent unless the issue is corrected, ERROR indicates issue with storing/saving expense instances, WARNING indicates there is an issue with the expense instance but it allows to user to send the expense instance

Available options:

BLOCKER,

ERROR,

WARNING

validationErrors.property

string

The field (property of a field in fields) the error applies to. Omitted when the error is not tied to a field.

validationErrors.expenseRecordId

string

Id of the expense record the error applies to. Omitted when not applicable.

⌘I

Expense type fields - initialize

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

import requests

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

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

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

print(response.text)

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

fetch('https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensetypes/{expenseType}/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}/expensetypes/{expenseType}/fields",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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}/expensetypes/{expenseType}/fields"

	req, _ := http.NewRequest("GET", 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))

}

HttpResponse<String> response = Unirest.get("https://stage-api.findity.com/api/v1/expense/me/organizations/{id}/expensetypes/{expenseType}/fields")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.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": "99601cd0f6ba438cb16ca17b8edf25a0",
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": null,
      "property": "version",
      "controlType": "INTEGER",
      "mandatory": false,
      "visible": false,
      "value": 2,
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Receipt",
      "property": "verification.receiptAttachment",
      "controlType": "CONTENT_HOLDER",
      "mandatory": false,
      "visible": true,
      "value": "receiptAttachmentId",
      "errorText": null,
      "error": null,
      "custom": false,
      "data": {
        "id": "receiptAttachmentId",
        "name": "name of receiptAttachment"
      }
    },
    {
      "name": "Category",
      "property": "categoryId",
      "controlType": "LIST",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false,
      "requiresUpdate": true,
      "scannable": true,
      "url": "/me/organizations/8ab28cb36ccde07d016ccdfb47d00216/expensetypes/ReceiptVerification/categories"
    },
    {
      "name": "Expense report",
      "property": "expenseReportId",
      "controlType": "LIST",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false,
      "url": "/expensereports?statuses=NORMAL,NEW&organizationId=8ab28cb36ccde07d016ccdfb47d00216"
    },
    {
      "name": "Verification number",
      "property": "verification.verificationNumber",
      "controlType": "TEXT",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false,
      "disabled": true
    },
    {
      "name": "Description",
      "property": "verification.description",
      "controlType": "TEXT",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Date of purchase",
      "property": "verification.purchaseDate",
      "controlType": "DATE",
      "mandatory": false,
      "visible": true,
      "value": "2019-09-30T14:33:26Z",
      "errorText": null,
      "error": null,
      "custom": false,
      "requiresUpdate": true,
      "scannable": true,
      "allowFutureDate": false
    },
    {
      "name": "Payment method",
      "property": "verification.paymentTypeId",
      "controlType": "LIST",
      "mandatory": true,
      "visible": true,
      "value": "f433bd56f038486faeee6a5ddd5177f2",
      "errorText": null,
      "error": null,
      "custom": false,
      "url": "/me/organizations/8ab28cb36ccde07d016ccdfb47d00216/paymenttypes",
      "data": {
        "iconUrl": null,
        "id": "f433bd56f038486faeee6a5ddd5177f2",
        "name": "Payment",
        "section": null
      }
    },
    {
      "name": "Store",
      "property": "verification.storeName",
      "controlType": "TEXT",
      "mandatory": false,
      "visible": false,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Amount incl. VAT",
      "property": "verification.amount",
      "controlType": "DOUBLE",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false,
      "scannable": true
    },
    {
      "name": "Tip",
      "property": "verification.tip",
      "controlType": "DOUBLE",
      "mandatory": false,
      "visible": false,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "VAT",
      "property": "verification.taxAmount",
      "controlType": "DOUBLE",
      "mandatory": false,
      "visible": true,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false,
      "scannable": true
    },
    {
      "name": "Currency",
      "property": "verification.currency",
      "controlType": "LIST",
      "mandatory": true,
      "visible": true,
      "value": "SEK",
      "errorText": null,
      "error": null,
      "custom": false,
      "requiresUpdate": true,
      "scannable": true,
      "url": "/me/organizations/8ab28cb36ccde07d016ccdfb47d00216/currencies",
      "data": {
        "iconUrl": null,
        "id": "SEK",
        "name": "Swedish Krona",
        "section": null
      }
    },
    {
      "name": "Exchange rate",
      "property": "verification.exchangeRate",
      "controlType": "DOUBLE",
      "mandatory": false,
      "visible": false,
      "value": 1,
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Expense Level (not-changable)",
      "property": "8ab28c4f70f773590170f7cda2ea08bc",
      "controlType": "LIST",
      "mandatory": false,
      "visible": false,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": true,
      "url": "/me/organizations/8ab28cb36ccde07d016ccdfb47d00216/lists/CUSTOM_DIMENSIONS_4f38a4cc3fe242d394058626523044c1_8ab28cb36ccde07d016ccdfb47d00216"
    },
    {
      "name": "Employee dim",
      "property": "8ab28c4f723887dd01723c5cae82020e",
      "controlType": "LIST",
      "mandatory": false,
      "visible": false,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": true,
      "url": "/me/organizations/8ab28cb36ccde07d016ccdfb47d00216/lists/CUSTOM_DIMENSIONS_d4c8684b75ff4026b69810c8d912aea4_8ab28cb36ccde07d016ccdfb47d00216"
    },
    {
      "name": "Entertainment",
      "property": "verification.representation",
      "controlType": "FIELD_GROUP",
      "mandatory": false,
      "visible": false,
      "value": null,
      "errorText": null,
      "error": null,
      "custom": false,
      "fields": [
        {
          "name": "Type",
          "property": "verification.representation.type",
          "controlType": "LIST",
          "mandatory": false,
          "visible": false,
          "value": null,
          "errorText": null,
          "error": null,
          "custom": false,
          "requiresUpdate": true
        },
        {
          "name": "Included liquor/wine/strong beer",
          "property": "verification.representation.includesLiquor",
          "controlType": "SWITCH",
          "mandatory": false,
          "visible": false,
          "value": null,
          "errorText": null,
          "error": null,
          "custom": false
        },
        {
          "name": "Attach guest list",
          "property": "verification.representation.guestListAttached",
          "controlType": "SWITCH",
          "mandatory": false,
          "visible": false,
          "value": false,
          "errorText": null,
          "error": null,
          "custom": false,
          "requiresUpdate": true
        },
        {
          "name": "Guests",
          "property": "verification.representation.guests",
          "controlType": "GUEST_LIST",
          "mandatory": false,
          "visible": false,
          "value": [],
          "errorText": null,
          "error": null,
          "custom": false
        },
        {
          "name": "Number of guests",
          "property": "verification.representation.numberOfGuests",
          "controlType": "INTEGER",
          "mandatory": false,
          "visible": false,
          "value": null,
          "errorText": null,
          "error": null,
          "custom": false
        },
        {
          "name": "Number of external guests",
          "property": "verification.representation.numberOfExternalGuests",
          "controlType": "INTEGER",
          "mandatory": false,
          "visible": false,
          "value": null,
          "errorText": null,
          "error": null,
          "custom": false
        },
        {
          "name": "Place",
          "property": "verification.representation.place",
          "controlType": "TEXT",
          "mandatory": false,
          "visible": false,
          "value": null,
          "errorText": null,
          "error": null,
          "custom": false
        },
        {
          "name": "Attached guest list",
          "property": "verification.representation.guestListAttachment",
          "controlType": "CONTENT_HOLDER",
          "mandatory": true,
          "visible": false,
          "value": "guestListAttachmentId",
          "errorText": null,
          "error": null,
          "custom": false,
          "data": {
            "id": "guestListAttachmentId",
            "name": "name of guestListAttachment"
          }
        }
      ],
      "commands": [
        {
          "text": "Clear guests",
          "confirmationRequired": true,
          "confirmation": "Are you sure you want to clear guests?",
          "command": "action=removeGuests"
        },
        {
          "text": "Clear representation",
          "confirmationRequired": true,
          "confirmation": "Are you sure you want to clear representation?",
          "command": "action=removeRepresentation"
        }
      ]
    },
    {
      "name": "Comment",
      "property": "verification.comment",
      "controlType": "MULTI_LINE_TEXT",
      "mandatory": false,
      "visible": true,
      "value": "Some comment",
      "errorText": null,
      "error": null,
      "custom": false
    },
    {
      "name": "Card transaction",
      "property": "verification.cardTransaction",
      "controlType": "TEXT",
      "mandatory": false,
      "visible": true,
      "value": "Some id",
      "errorText": null,
      "error": null,
      "custom": false,
      "disabled": true
    },
    {
      "name": "Attachments",
      "property": "verification.attachments",
      "controlType": "CONTENT_HOLDER",
      "mandatory": false,
      "visible": true,
      "value": [
        "id1",
        "id2"
      ],
      "errorText": null,
      "error": null,
      "custom": false,
      "disabled": false,
      "data": [
        {
          "id": "id1",
          "name": "name of attachment with id1"
        },
        {
          "id": "id2",
          "name": "name of attachment with id2"
        }
      ]
    }
  ]
}

Authentication

Findity Expense API

Findity Admin API

Findity Admin API V0

Findity Connect API

Expense type fields - initialize

Authorizations

Path Parameters

Query Parameters

Response