Create a new expense

POST

expenses

curl --request POST \
  --url https://stage-api.findity.com/api/v1/expense/expenses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "receiptVerification": {
    "value": {
      "organizationId": "ff80818196390109019639014c14004b",
      "categoryId": "e1bb2ae57f604adfa8193a2c5da010d9",
      "verification": {
        "comment": "verification-comment",
        "type": "ReceiptVerification",
        "amount": 230,
        "taxAmount": 23,
        "tip": 10,
        "exchangeRate": 1,
        "currency": "SEK",
        "customFields": [
          {
            "fieldDefinitionId": "2b965c866b634698811dabf45a491089,",
            "value": true
          },
          {
            "fieldDefinitionId": "59ljgfau904t3qio3aw90up34gj9iog4,",
            "value": "string"
          },
          {
            "fieldDefinitionId": "904t3qio3aw90up34gj9iog45a491089,",
            "value": 10
          }
        ],
        "description": "verification-description",
        "purchaseDate": "2023-03-21T10:58:14Z",
        "storeName": "The store",
        "verificationNumber": "verification-number",
        "paymentTypeId": "a7384ac0d3dc45bf9d15f8de343cf612",
        "receiptAttachment": {
          "id": "08d6f126078e49509e8d7857b3a19472"
        }
      }
    }
  },
  "receiptVerification with representation including guest list": {
    "value": {
      "organizationId": "ff80818196390109019639014c14004b",
      "personId": "ff80818196390109019639014a560022",
      "reimbursementCurrency": "SEK",
      "categoryId": "e1bb2ae57f604adfa8193a2c5da010d9",
      "status": "NORMAL",
      "expenseDate": "2025-04-15T10:31:48Z",
      "verification": {
        "comment": "verification-comment",
        "type": "ReceiptVerification",
        "amount": 230,
        "taxAmount": 23,
        "tip": 10,
        "exchangeRate": 1,
        "currency": "SEK",
        "customFields": [
          {
            "fieldDefinitionId": "2b965c866b634698811dabf45a491089,",
            "value": true
          },
          {
            "fieldDefinitionId": "59ljgfau904t3qio3aw90up34gj9iog4,",
            "value": "string"
          },
          {
            "fieldDefinitionId": "904t3qio3aw90up34gj9iog45a491089,",
            "value": 10
          }
        ],
        "description": "verification-description",
        "purchaseDate": "2023-03-21T10:58:14Z",
        "storeName": "The store",
        "verificationNumber": "verification-number",
        "paymentTypeId": "a7384ac0d3dc45bf9d15f8de343cf612",
        "receiptAttachment": {
          "id": "08d6f126078e49509e8d7857b3a19472"
        },
        "representation": {
          "type": "LUNCH",
          "includesLiquor": false,
          "guests": null,
          "guestListAttached": true,
          "guestListAttachment": {
            "id": "73e3aa129fbc46348d60f1f6338346a8"
          },
          "numberOfGuests": 3,
          "numberOfExternalGuests": 5,
          "tip": 10,
          "place": "Name of place"
        }
      }
    }
  },
  "receiptVerification with representation including attached guests": {
    "value": {
      "organizationId": "ff80818196390109019639014c14004b",
      "personId": "ff80818196390109019639014a560022",
      "reimbursementCurrency": "SEK",
      "categoryId": "e1bb2ae57f604adfa8193a2c5da010d9",
      "status": "NORMAL",
      "expenseDate": "2025-04-15T10:31:48Z",
      "verification": {
        "comment": "verification-comment",
        "type": "ReceiptVerification",
        "amount": 230,
        "taxAmount": 23,
        "tip": 10,
        "exchangeRate": 1,
        "currency": "SEK",
        "customFields": [
          {
            "fieldDefinitionId": "2b965c866b634698811dabf45a491089,",
            "value": true
          },
          {
            "fieldDefinitionId": "59ljgfau904t3qio3aw90up34gj9iog4,",
            "value": "string"
          },
          {
            "fieldDefinitionId": "904t3qio3aw90up34gj9iog45a491089,",
            "value": 10
          }
        ],
        "description": "verification-description",
        "purchaseDate": "2023-03-21T10:58:14Z",
        "storeName": "The store",
        "verificationNumber": "verification-number",
        "paymentTypeId": "a7384ac0d3dc45bf9d15f8de343cf612",
        "receiptAttachment": {
          "id": "08d6f126078e49509e8d7857b3a19472"
        },
        "representation": {
          "type": "LUNCH",
          "includesLiquor": false,
          "guests": [
            {
              "name": "Person 1",
              "company": "Company A"
            },
            {
              "name": "Person 2",
              "company": "Company B"
            }
          ],
          "guestListAttached": false,
          "guestListAttachment": null,
          "numberOfGuests": 2,
          "numberOfExternalGuests": 5,
          "tip": 10,
          "place": "Name of place"
        }
      }
    }
  }
}
'

{
  "receiptVerification": {
    "value": {
      "organizationId": "ff808181963de13701963de1789d00ad",
      "version": 2,
      "lastUpdated": "2025-04-16T09:15:09Z",
      "dateCreated": "2025-04-16T09:15:09Z",
      "processStatus": "DRAFT",
      "status": "NORMAL",
      "expenseDate": "2023-03-21T10:58:14Z",
      "personId": "ff808181963de13701963de177e00083",
      "id": "5ca0dfa6def943eab46d240d3680c323",
      "reimbursementCurrency": "SEK",
      "categoryId": "9ed4618ae74e4f17b69005f699c104f3",
      "verification": {
        "amount": 230,
        "purchaseDate": "2023-03-21T10:58:14Z",
        "attachments": [
          {
            "name": "attachments2",
            "isTemporary": false,
            "id": "ff808181963e296501963e29ac6d00be",
            "contentType": "image/jpeg"
          },
          {
            "name": "attachments1",
            "isTemporary": false,
            "id": "ff808181963e296501963e29ac5e00bc",
            "contentType": "image/jpeg"
          }
        ],
        "customFields": [
          {
            "fieldDefinitionId": "2b965c866b634698811dabf45a491089,",
            "value": true
          },
          {
            "fieldDefinitionId": "59ljgfau904t3qio3aw90up34gj9iog4,",
            "value": "string"
          },
          {
            "fieldDefinitionId": "904t3qio3aw90up34gj9iog45a491089,",
            "value": 10
          }
        ],
        "description": "verification-description",
        "type": "ReceiptVerification",
        "lastUpdated": "2025-04-16T09:15:09Z",
        "dateCreated": "2025-04-16T09:15:09Z",
        "paymentTypeId": "ed0d98d4e3834714bbca45f889d4584b",
        "exchangeRate": 1,
        "verificationNumber": "verification-number",
        "comment": "verification-comment",
        "currency": "SEK",
        "taxAmount": 23,
        "receiptAttachment": {
          "name": "file-name607803656",
          "personId": "ff808181963de13701963de177e00083",
          "isTemporary": false,
          "id": "ff808181963de13701963de179b900b9",
          "contentType": "image/png"
        }
      }
    }
  },
  "receiptVerification with representation including guest list": {
    "value": {
      "organizationId": "ff808181963e1df601963e2657bf01ec",
      "lastUpdated": "2025-04-16T10:30:22Z",
      "dateCreated": "2025-04-16T10:30:22Z",
      "processStatus": "DRAFT",
      "personId": "ff808181963e1df601963e26577201c2",
      "id": "043c3ef85bea4e118adabbba4c3d16bf",
      "reimbursementCurrency": "SEK",
      "categoryId": "e59971ac44b54f2480d449b0d84caee2",
      "status": "NORMAL",
      "expenseDate": "2023-03-21T10:58:14Z",
      "verification": {
        "amount": 230,
        "purchaseDate": "2023-03-21T10:58:14Z",
        "attachments": [
          {
            "name": "attachments2",
            "isTemporary": false,
            "id": "ff808181963e296501963e29ac6d00be",
            "contentType": "image/jpeg"
          },
          {
            "name": "attachments1",
            "isTemporary": false,
            "id": "ff808181963e296501963e29ac5e00bc",
            "contentType": "image/jpeg"
          }
        ],
        "customFields": [
          {
            "fieldDefinitionId": "2b965c866b634698811dabf45a491089,",
            "value": true
          }
        ],
        "description": "verification-description",
        "type": "ReceiptVerification",
        "lastUpdated": "2025-04-16T10:30:22Z",
        "dateCreated": "2025-04-16T10:30:22Z",
        "paymentTypeId": "253b87a3555a4c9bb288338131d2d83b",
        "exchangeRate": 1,
        "verificationNumber": "verification-number",
        "comment": "verification-comment",
        "currency": "SEK",
        "taxAmount": 23,
        "receiptAttachment": {
          "name": "file-name1011137852",
          "personId": "ff808181963e1df601963e26577201c2",
          "isTemporary": false,
          "id": "ff808181963e1df601963e26582601f8",
          "contentType": "image/png"
        },
        "representation": {
          "includesLiquor": false,
          "numberOfExternalGuests": 1,
          "guests": [],
          "numberOfGuests": 1,
          "type": "LUNCH",
          "guestListAttached": true,
          "guestListAttachment": {
            "name": "file-name386996737",
            "personId": "ff808181963e1df601963e26577201c2",
            "isTemporary": false,
            "id": "ff808181963e1df601963e26583101f9",
            "contentType": "application/pdf"
          }
        }
      }
    }
  },
  "receiptVerification with representation including attached guests": {
    "value": {
      "organizationId": "ff808181963e1df601963e1f931f014b",
      "lastUpdated": "2025-04-16T10:22:59Z",
      "dateCreated": "2025-04-16T10:22:59Z",
      "processStatus": "DRAFT",
      "personId": "ff808181963e1df601963e1f92d30121",
      "id": "7c50f82edb7747bdb84f038e535f1e7d",
      "reimbursementCurrency": "SEK",
      "categoryId": "ebde877306a94f66a9b0695c7c48a43d",
      "status": "NORMAL",
      "expenseDate": "2023-03-21T10:58:14Z",
      "verification": {
        "amount": 230,
        "purchaseDate": "2023-03-21T10:58:14Z",
        "attachments": [
          {
            "name": "attachments2",
            "isTemporary": false,
            "id": "ff808181963e296501963e29ac6d00be",
            "contentType": "image/jpeg"
          },
          {
            "name": "attachments1",
            "isTemporary": false,
            "id": "ff808181963e296501963e29ac5e00bc",
            "contentType": "image/jpeg"
          }
        ],
        "customFields": [
          {
            "fieldDefinitionId": "058d2a973694413db017b9e340f15d2d",
            "value": "2023-01-01T01:00:00Z"
          }
        ],
        "description": "verification-description",
        "type": "ReceiptVerification",
        "lastUpdated": "2025-04-16T10:22:59Z",
        "dateCreated": "2025-04-16T10:22:59Z",
        "paymentTypeId": "1f4d4253c7c740c7ae055d840d25392a",
        "exchangeRate": 1,
        "verificationNumber": "verification-number",
        "comment": "verification-comment",
        "currency": "SEK",
        "taxAmount": 23,
        "receiptAttachment": {
          "name": "file-name985238297",
          "personId": "ff808181963e1df601963e1f92d30121",
          "isTemporary": false,
          "id": "ff808181963e1df601963e1f93810157",
          "contentType": "image/png"
        },
        "representation": {
          "includesLiquor": false,
          "numberOfExternalGuests": 1,
          "type": "LUNCH",
          "guestListAttached": false,
          "guests": [
            {
              "name": "Person 1",
              "company": "Company A"
            },
            {
              "name": "Person 2",
              "company": "Company B"
            }
          ]
        }
      }
    }
  }
}

Authorizations

Authorization

string

header

required

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

Query Parameters

include

enum<string>[]

optional properties to include

Available options:

verification,

meta.abbreviation,

meta.abbreviation.labels,

meta.person,

meta.capabilities,

meta.cardTransaction,

meta.splits,

validationErrors

forceSave

boolean

When true, saves the report even if non-blocking validation warnings exist; validation errors still abort. Defaults to false.

Body

application/json

ExpenseRecord format

organizationId

string

required

UUID without dashes (32-character hex string)

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

categoryId

string

required

UUID without dashes (32-character hex string)

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

verification

object

required

The expense-type-specific payload — receipt details, mileage details, per-diem details, or food-benefit details. Shape selected by the nested type discriminator.

Option 1
Option 2
Option 3
Option 4

Hide child attributes

verification.reimbursement

number

verification.comment

string

verification.type

enum<string>

Available options:

ReceiptVerification

verification.amount

number

verification.taxAmount

number

verification.tip

number<double>

The tip amount for the receipt, expressed as a non-negative decimal number in the receipt's currency. This is the canonical location for tip. For backwards compatibility the value is also mirrored on the deprecated representation.tip property.

Required range: x >= 0

verification.exchangeRate

number

verification.currency

string

verification.description

string

verification.purchaseDate

string<date-time>

verification.dateCreated

string

verification.lastUpdated

string

verification.storeName

string

verification.verificationNumber

string

verification.paymentTypeId

string

verification.cardTransactionId

string

verification.eventType

enum<string>

Available options:

AUTHORIZATION_ACCEPTED,

AUTHORIZATION_REJECTED,

AUTHORIZATION_REVERSAL,

CAPTURE,

REFUND

verification.receiptAttachment

object

Hide child attributes

verification.receiptAttachment.id

string

UUID without dashes (32-character hex string)

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

verification.receiptAttachment.personId

string

UUID without dashes (32-character hex string)

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

verification.receiptAttachment.contentType

string

verification.receiptAttachment.isTemporary

boolean

verification.receiptAttachment.signatureType

enum<string>

Available options:

EU

verification.receiptAttachment.signatureUrl

string

verification.receiptAttachment.name

string

verification.receiptAttachment.description

string

verification.receiptAttachment.qrScan

string

Decoded fiscal QR string as sent in the qrScan request header on POST. Omitted when the resource has no QR data attached. Currently populated for Portuguese receipts.

Example:

{
  "id": "62bfaa54dc9341819cd6f4ff4ae39f44",
  "personId": "063ee3c7fa4b4728b418097299447f9d",
  "contentType": "application/pdf",
  "isTemporary": true,
  "signatureType": null,
  "signatureUrl": null,
  "name": "receipt-photo.jpg",
  "description": "Receipt photo",
  "qrScan": "A:514482621*B:501878076*C:PT*D:FR*E:N*F:20260508*G:111 26A/154*H:J6Z9V4MR-154*I1:PT-MA*I7:68.50*I8:15.76*N:15.76*O:84.26*Q:T4Fn*R:116",
  "scanResult": {
    "id": "a185160800524ac68cbf0a18ad59649b",
    "amount": 135,
    "taxAmount": 23,
    "currency": "SEK",
    "purchaseDate": "2023-04-20",
    "categoryIds": [
      "575ba2572de74f38b947a07df93a2909",
      "350dadb020694421aebc1d9473fa64a9"
    ],
    "categoryId": "575ba2572de74f38b947a07df93a2909"
  }
}

verification.representation

object

Hide child attributes

verification.representation.type

string

verification.representation.guestListAttached

boolean

default:false

verification.representation.includesLiquor

boolean

default:false

verification.representation.numberOfGuests

integer

verification.representation.numberOfExternalGuests

integer

verification.representation.place

string

verification.representation.tip

number<double>

deprecated

Deprecated. Tip is now a root receipt verification property (tip). A non-negative decimal number in the receipt's currency. This property is kept for backwards compatibility and mirrors the root value.

Required range: x >= 0

verification.representation.guestListAttachment

object

Hide child attributes

verification.representation.guestListAttachment.id

string

UUID without dashes (32-character hex string)

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

verification.representation.guestListAttachment.personId

string

UUID without dashes (32-character hex string)

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

verification.representation.guestListAttachment.contentType

string

verification.representation.guestListAttachment.isTemporary

boolean

verification.representation.guestListAttachment.signatureType

enum<string>

Available options:

EU

verification.representation.guestListAttachment.signatureUrl

string

verification.representation.guestListAttachment.name

string

verification.representation.guestListAttachment.description

string

verification.representation.guestListAttachment.qrScan

string

Decoded fiscal QR string as sent in the qrScan request header on POST. Omitted when the resource has no QR data attached. Currently populated for Portuguese receipts.

Example:

{
  "id": "62bfaa54dc9341819cd6f4ff4ae39f44",
  "personId": "063ee3c7fa4b4728b418097299447f9d",
  "contentType": "application/pdf",
  "isTemporary": true,
  "signatureType": null,
  "signatureUrl": null,
  "name": "receipt-photo.jpg",
  "description": "Receipt photo",
  "qrScan": "A:514482621*B:501878076*C:PT*D:FR*E:N*F:20260508*G:111 26A/154*H:J6Z9V4MR-154*I1:PT-MA*I7:68.50*I8:15.76*N:15.76*O:84.26*Q:T4Fn*R:116",
  "scanResult": {
    "id": "a185160800524ac68cbf0a18ad59649b",
    "amount": 135,
    "taxAmount": 23,
    "currency": "SEK",
    "purchaseDate": "2023-04-20",
    "categoryIds": [
      "575ba2572de74f38b947a07df93a2909",
      "350dadb020694421aebc1d9473fa64a9"
    ],
    "categoryId": "575ba2572de74f38b947a07df93a2909"
  }
}

verification.representation.guests

object[]

Hide child attributes

verification.representation.guests.name

string

verification.representation.guests.company

string

verification.attachments

object[]

Hide child attributes

verification.attachments.id

string

UUID without dashes (32-character hex string)

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

verification.attachments.personId

string

UUID without dashes (32-character hex string)

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

verification.attachments.contentType

string

verification.attachments.isTemporary

boolean

verification.attachments.signatureType

enum<string>

Available options:

EU

verification.attachments.signatureUrl

string

verification.attachments.name

string

verification.attachments.description

string

verification.attachments.qrScan

string

Decoded fiscal QR string as sent in the qrScan request header on POST. Omitted when the resource has no QR data attached. Currently populated for Portuguese receipts.

verification.customFields

object[]

Hide child attributes

verification.customFields.fieldDefinitionId

string

UUID without dashes (32-character hex string)

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

verification.customFields.value

any

Can be: string, number, integer, date, boolean

verification.taxRates

object[]

Hide child attributes

verification.taxRates.taxRateId

string

UUID without dashes (32-character hex string)

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

verification.taxRates.rate

number<double>

verification.taxRates.taxAmount

number<double>

version

integer<int64>

Optimistic-lock counter, incremented on every update. On PUT, echo back the value from the last GET/PUT response to detect if the expense was changed by someone else since it was read; a mismatch returns 409. Optional; omit to skip this check.

expenseReportId

string

UUID without dashes (32-character hex string)

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

Response

ExpenseRecord format

string

read-only

status

enum<string>

read-only

Available options:

NEW,

NORMAL,

APPROVAL,

APPROVED,

REJECTED

personId

string

read-only

UUID without dashes (32-character hex string)

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

dateCreated

string

read-only

lastUpdated

string

read-only

version

integer<int64>

expenseDate

string

read-only

Date that the user has selected for the expense. For receipt expenses it is purchase date. For mileages it is travel date and for per diems it is the first travel date.

organizationId

string

UUID without dashes (32-character hex string)

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

categoryId

string

UUID without dashes (32-character hex string)

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

rejectComment

string

read-only

reimbursement

number

read-only

reimbursementCurrency

string

read-only

meta

object

read-only

Hide child attributes

meta.categoryIconUrl

string

Example:

"https://expense.findity.com/api/resources/8a5f867e9b204742a8cc2ca2b6c57358"

meta.person

object

Hide child attributes

meta.person.firstName

string

Example:

"Anna"

meta.person.lastName

string

Example:

"Andersson"

meta.person.email

string

Example:

"anna.andersson@example.com"

meta.abbreviation

object

Option 1
Option 2
Option 3
Option 4

Hide child attributes

meta.abbreviation.iconUrl

string

Example:

"https://expense.findity.com/api/resources/ba479b6fe32f4d5e87e6dda1e02e850b"

meta.abbreviation.dateDescription

string

Date formatted according to users locale

Example:

"June 2, 2023"

meta.abbreviation.sortDescription

string

Description of the value used for sorting

Example:

"June 1, 2023"

meta.abbreviation.userDescription

string

Example:

"Pens and erasers"

meta.abbreviation.expenseDescription

string

Description which contains the name of category

Example:

"Office supplies"

meta.abbreviation.reimbursementDescription

string

Reimbursement amount and currency formatted according to users locale

Example:

"44.5 SEK"

meta.abbreviation.totalReimbursementDescription

string

Total reimbursement amount and currency formatted according to users locale, only included if requesting meta.splits and the expense is the parent

Example:

"44.5 SEK"

meta.abbreviation.alert

boolean

If the report is rejected or contains expenses that has validation errors

meta.abbreviation.isComplete

boolean

If the expense is complete and ready to be sent, can contain warnings.

meta.abbreviation.expenseType

string

Example:

"ReceiptVerification"

meta.abbreviation.expenseTypeDescription

string

description of expenseType property translated to the users language

meta.capabilities

object

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

meta.cardTransaction

object

Hide child attributes

meta.cardTransaction.id

string

UUID without dashes (32-character hex string)

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

Example:

"4a17f93476ce4bf2832236be26743853"

meta.cardTransaction.amount

number<double>

Example:

120

meta.cardTransaction.name

string

Example:

"Bank name"

meta.cardTransaction.cardNumber

string

Example:

"xxxxxxxxxxxx1234"

verification

object

The expense-type-specific payload — receipt details, mileage details, per-diem details, or food-benefit details. Shape selected by the nested type discriminator.

Option 1
Option 2
Option 3
Option 4

Hide child attributes

verification.id

string

read-only

UUID without dashes (32-character hex string)

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

verification.reimbursement

number

verification.comment

string

verification.type

enum<string>

Available options:

ReceiptVerification

verification.amount

number

verification.taxAmount

number

verification.tip

number<double>

Required range: x >= 0

verification.exchangeRate

number

verification.currency

string

verification.description

string

verification.purchaseDate

string<date-time>

verification.dateCreated

string

verification.lastUpdated

string

verification.storeName

string

verification.verificationNumber

string

verification.paymentTypeId

string

verification.cardTransactionId

string

verification.eventType

enum<string>

Available options:

AUTHORIZATION_ACCEPTED,

AUTHORIZATION_REJECTED,

AUTHORIZATION_REVERSAL,

CAPTURE,

REFUND

verification.receiptAttachment

object

Hide child attributes

verification.receiptAttachment.id

string

UUID without dashes (32-character hex string)

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

verification.receiptAttachment.personId

string

UUID without dashes (32-character hex string)

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

verification.receiptAttachment.contentType

string

verification.receiptAttachment.isTemporary

boolean

verification.receiptAttachment.signatureType

enum<string>

Available options:

EU

verification.receiptAttachment.signatureUrl

string

verification.receiptAttachment.name

string

verification.receiptAttachment.description

string

verification.receiptAttachment.qrScan

string

Decoded fiscal QR string as sent in the qrScan request header on POST. Omitted when the resource has no QR data attached. Currently populated for Portuguese receipts.

verification.receiptAttachment.scanResult

object

read-only

Hide child attributes

verification.receiptAttachment.scanResult.id

string

UUID without dashes (32-character hex string)

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

verification.receiptAttachment.scanResult.amount

number<double>

verification.receiptAttachment.scanResult.taxAmount

number<double>

verification.receiptAttachment.scanResult.currency

string

verification.receiptAttachment.scanResult.purchaseDate

string

verification.receiptAttachment.scanResult.categoryIds

string[]

UUID without dashes (32-character hex string)

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

verification.receiptAttachment.scanResult.categoryId

string

UUID without dashes (32-character hex string)

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

Example:

{
  "id": "62bfaa54dc9341819cd6f4ff4ae39f44",
  "personId": "063ee3c7fa4b4728b418097299447f9d",
  "contentType": "application/pdf",
  "isTemporary": true,
  "signatureType": null,
  "signatureUrl": null,
  "name": "receipt-photo.jpg",
  "description": "Receipt photo",
  "qrScan": "A:514482621*B:501878076*C:PT*D:FR*E:N*F:20260508*G:111 26A/154*H:J6Z9V4MR-154*I1:PT-MA*I7:68.50*I8:15.76*N:15.76*O:84.26*Q:T4Fn*R:116",
  "scanResult": {
    "id": "a185160800524ac68cbf0a18ad59649b",
    "amount": 135,
    "taxAmount": 23,
    "currency": "SEK",
    "purchaseDate": "2023-04-20",
    "categoryIds": [
      "575ba2572de74f38b947a07df93a2909",
      "350dadb020694421aebc1d9473fa64a9"
    ],
    "categoryId": "575ba2572de74f38b947a07df93a2909"
  }
}

verification.representation

object

Hide child attributes

verification.representation.type

string

verification.representation.guestListAttached

boolean

default:false

verification.representation.includesLiquor

boolean

default:false

verification.representation.numberOfGuests

integer

verification.representation.numberOfExternalGuests

integer

verification.representation.place

string

verification.representation.tip

number<double>

deprecated

Required range: x >= 0

verification.representation.guestListAttachment

object

Hide child attributes

verification.representation.guestListAttachment.id

string

UUID without dashes (32-character hex string)

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

verification.representation.guestListAttachment.personId

string

UUID without dashes (32-character hex string)

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

verification.representation.guestListAttachment.contentType

string

verification.representation.guestListAttachment.isTemporary

boolean

verification.representation.guestListAttachment.signatureType

enum<string>

Available options:

EU

verification.representation.guestListAttachment.signatureUrl

string

verification.representation.guestListAttachment.name

string

verification.representation.guestListAttachment.description

string

verification.representation.guestListAttachment.qrScan

string

Decoded fiscal QR string as sent in the qrScan request header on POST. Omitted when the resource has no QR data attached. Currently populated for Portuguese receipts.

verification.representation.guestListAttachment.scanResult

object

read-only

Hide child attributes

verification.representation.guestListAttachment.scanResult.id

string

UUID without dashes (32-character hex string)

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

verification.representation.guestListAttachment.scanResult.amount

number<double>

verification.representation.guestListAttachment.scanResult.taxAmount

number<double>

verification.representation.guestListAttachment.scanResult.currency

string

verification.representation.guestListAttachment.scanResult.purchaseDate

string

verification.representation.guestListAttachment.scanResult.categoryIds

string[]

UUID without dashes (32-character hex string)

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

verification.representation.guestListAttachment.scanResult.categoryId

string

UUID without dashes (32-character hex string)

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

Example:

{
  "id": "62bfaa54dc9341819cd6f4ff4ae39f44",
  "personId": "063ee3c7fa4b4728b418097299447f9d",
  "contentType": "application/pdf",
  "isTemporary": true,
  "signatureType": null,
  "signatureUrl": null,
  "name": "receipt-photo.jpg",
  "description": "Receipt photo",
  "qrScan": "A:514482621*B:501878076*C:PT*D:FR*E:N*F:20260508*G:111 26A/154*H:J6Z9V4MR-154*I1:PT-MA*I7:68.50*I8:15.76*N:15.76*O:84.26*Q:T4Fn*R:116",
  "scanResult": {
    "id": "a185160800524ac68cbf0a18ad59649b",
    "amount": 135,
    "taxAmount": 23,
    "currency": "SEK",
    "purchaseDate": "2023-04-20",
    "categoryIds": [
      "575ba2572de74f38b947a07df93a2909",
      "350dadb020694421aebc1d9473fa64a9"
    ],
    "categoryId": "575ba2572de74f38b947a07df93a2909"
  }
}

verification.representation.guests

object[]

Hide child attributes

verification.representation.guests.name

string

verification.representation.guests.company

string

verification.attachments

object[]

Hide child attributes

verification.attachments.id

string

UUID without dashes (32-character hex string)

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

verification.attachments.personId

string

UUID without dashes (32-character hex string)

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

verification.attachments.contentType

string

verification.attachments.isTemporary

boolean

verification.attachments.signatureType

enum<string>

Available options:

EU

verification.attachments.signatureUrl

string

verification.attachments.name

string

verification.attachments.description

string

verification.attachments.qrScan

string

Decoded fiscal QR string as sent in the qrScan request header on POST. Omitted when the resource has no QR data attached. Currently populated for Portuguese receipts.

verification.attachments.scanResult

object

read-only

Hide child attributes

verification.attachments.scanResult.id

string

UUID without dashes (32-character hex string)

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

verification.attachments.scanResult.amount

number<double>

verification.attachments.scanResult.taxAmount

number<double>

verification.attachments.scanResult.currency

string

verification.attachments.scanResult.purchaseDate

string

verification.attachments.scanResult.categoryIds

string[]

UUID without dashes (32-character hex string)

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

verification.attachments.scanResult.categoryId

string

UUID without dashes (32-character hex string)

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

verification.customFields

object[]

Hide child attributes

verification.customFields.fieldDefinitionId

string

UUID without dashes (32-character hex string)

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

verification.customFields.value

any

Can be: string, number, integer, date, boolean

verification.taxRates

object[]

Hide child attributes

verification.taxRates.taxRateId

string

UUID without dashes (32-character hex string)

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

verification.taxRates.rate

number<double>

verification.taxRates.taxAmount

number<double>

expenseReportId

string

UUID without dashes (32-character hex string)

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

⌘I

curl --request POST \
  --url https://stage-api.findity.com/api/v1/expense/expenses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "receiptVerification": {
    "value": {
      "organizationId": "ff80818196390109019639014c14004b",
      "categoryId": "e1bb2ae57f604adfa8193a2c5da010d9",
      "verification": {
        "comment": "verification-comment",
        "type": "ReceiptVerification",
        "amount": 230,
        "taxAmount": 23,
        "tip": 10,
        "exchangeRate": 1,
        "currency": "SEK",
        "customFields": [
          {
            "fieldDefinitionId": "2b965c866b634698811dabf45a491089,",
            "value": true
          },
          {
            "fieldDefinitionId": "59ljgfau904t3qio3aw90up34gj9iog4,",
            "value": "string"
          },
          {
            "fieldDefinitionId": "904t3qio3aw90up34gj9iog45a491089,",
            "value": 10
          }
        ],
        "description": "verification-description",
        "purchaseDate": "2023-03-21T10:58:14Z",
        "storeName": "The store",
        "verificationNumber": "verification-number",
        "paymentTypeId": "a7384ac0d3dc45bf9d15f8de343cf612",
        "receiptAttachment": {
          "id": "08d6f126078e49509e8d7857b3a19472"
        }
      }
    }
  },
  "receiptVerification with representation including guest list": {
    "value": {
      "organizationId": "ff80818196390109019639014c14004b",
      "personId": "ff80818196390109019639014a560022",
      "reimbursementCurrency": "SEK",
      "categoryId": "e1bb2ae57f604adfa8193a2c5da010d9",
      "status": "NORMAL",
      "expenseDate": "2025-04-15T10:31:48Z",
      "verification": {
        "comment": "verification-comment",
        "type": "ReceiptVerification",
        "amount": 230,
        "taxAmount": 23,
        "tip": 10,
        "exchangeRate": 1,
        "currency": "SEK",
        "customFields": [
          {
            "fieldDefinitionId": "2b965c866b634698811dabf45a491089,",
            "value": true
          },
          {
            "fieldDefinitionId": "59ljgfau904t3qio3aw90up34gj9iog4,",
            "value": "string"
          },
          {
            "fieldDefinitionId": "904t3qio3aw90up34gj9iog45a491089,",
            "value": 10
          }
        ],
        "description": "verification-description",
        "purchaseDate": "2023-03-21T10:58:14Z",
        "storeName": "The store",
        "verificationNumber": "verification-number",
        "paymentTypeId": "a7384ac0d3dc45bf9d15f8de343cf612",
        "receiptAttachment": {
          "id": "08d6f126078e49509e8d7857b3a19472"
        },
        "representation": {
          "type": "LUNCH",
          "includesLiquor": false,
          "guests": null,
          "guestListAttached": true,
          "guestListAttachment": {
            "id": "73e3aa129fbc46348d60f1f6338346a8"
          },
          "numberOfGuests": 3,
          "numberOfExternalGuests": 5,
          "tip": 10,
          "place": "Name of place"
        }
      }
    }
  },
  "receiptVerification with representation including attached guests": {
    "value": {
      "organizationId": "ff80818196390109019639014c14004b",
      "personId": "ff80818196390109019639014a560022",
      "reimbursementCurrency": "SEK",
      "categoryId": "e1bb2ae57f604adfa8193a2c5da010d9",
      "status": "NORMAL",
      "expenseDate": "2025-04-15T10:31:48Z",
      "verification": {
        "comment": "verification-comment",
        "type": "ReceiptVerification",
        "amount": 230,
        "taxAmount": 23,
        "tip": 10,
        "exchangeRate": 1,
        "currency": "SEK",
        "customFields": [
          {
            "fieldDefinitionId": "2b965c866b634698811dabf45a491089,",
            "value": true
          },
          {
            "fieldDefinitionId": "59ljgfau904t3qio3aw90up34gj9iog4,",
            "value": "string"
          },
          {
            "fieldDefinitionId": "904t3qio3aw90up34gj9iog45a491089,",
            "value": 10
          }
        ],
        "description": "verification-description",
        "purchaseDate": "2023-03-21T10:58:14Z",
        "storeName": "The store",
        "verificationNumber": "verification-number",
        "paymentTypeId": "a7384ac0d3dc45bf9d15f8de343cf612",
        "receiptAttachment": {
          "id": "08d6f126078e49509e8d7857b3a19472"
        },
        "representation": {
          "type": "LUNCH",
          "includesLiquor": false,
          "guests": [
            {
              "name": "Person 1",
              "company": "Company A"
            },
            {
              "name": "Person 2",
              "company": "Company B"
            }
          ],
          "guestListAttached": false,
          "guestListAttachment": null,
          "numberOfGuests": 2,
          "numberOfExternalGuests": 5,
          "tip": 10,
          "place": "Name of place"
        }
      }
    }
  }
}
'

{
  "receiptVerification": {
    "value": {
      "organizationId": "ff808181963de13701963de1789d00ad",
      "version": 2,
      "lastUpdated": "2025-04-16T09:15:09Z",
      "dateCreated": "2025-04-16T09:15:09Z",
      "processStatus": "DRAFT",
      "status": "NORMAL",
      "expenseDate": "2023-03-21T10:58:14Z",
      "personId": "ff808181963de13701963de177e00083",
      "id": "5ca0dfa6def943eab46d240d3680c323",
      "reimbursementCurrency": "SEK",
      "categoryId": "9ed4618ae74e4f17b69005f699c104f3",
      "verification": {
        "amount": 230,
        "purchaseDate": "2023-03-21T10:58:14Z",
        "attachments": [
          {
            "name": "attachments2",
            "isTemporary": false,
            "id": "ff808181963e296501963e29ac6d00be",
            "contentType": "image/jpeg"
          },
          {
            "name": "attachments1",
            "isTemporary": false,
            "id": "ff808181963e296501963e29ac5e00bc",
            "contentType": "image/jpeg"
          }
        ],
        "customFields": [
          {
            "fieldDefinitionId": "2b965c866b634698811dabf45a491089,",
            "value": true
          },
          {
            "fieldDefinitionId": "59ljgfau904t3qio3aw90up34gj9iog4,",
            "value": "string"
          },
          {
            "fieldDefinitionId": "904t3qio3aw90up34gj9iog45a491089,",
            "value": 10
          }
        ],
        "description": "verification-description",
        "type": "ReceiptVerification",
        "lastUpdated": "2025-04-16T09:15:09Z",
        "dateCreated": "2025-04-16T09:15:09Z",
        "paymentTypeId": "ed0d98d4e3834714bbca45f889d4584b",
        "exchangeRate": 1,
        "verificationNumber": "verification-number",
        "comment": "verification-comment",
        "currency": "SEK",
        "taxAmount": 23,
        "receiptAttachment": {
          "name": "file-name607803656",
          "personId": "ff808181963de13701963de177e00083",
          "isTemporary": false,
          "id": "ff808181963de13701963de179b900b9",
          "contentType": "image/png"
        }
      }
    }
  },
  "receiptVerification with representation including guest list": {
    "value": {
      "organizationId": "ff808181963e1df601963e2657bf01ec",
      "lastUpdated": "2025-04-16T10:30:22Z",
      "dateCreated": "2025-04-16T10:30:22Z",
      "processStatus": "DRAFT",
      "personId": "ff808181963e1df601963e26577201c2",
      "id": "043c3ef85bea4e118adabbba4c3d16bf",
      "reimbursementCurrency": "SEK",
      "categoryId": "e59971ac44b54f2480d449b0d84caee2",
      "status": "NORMAL",
      "expenseDate": "2023-03-21T10:58:14Z",
      "verification": {
        "amount": 230,
        "purchaseDate": "2023-03-21T10:58:14Z",
        "attachments": [
          {
            "name": "attachments2",
            "isTemporary": false,
            "id": "ff808181963e296501963e29ac6d00be",
            "contentType": "image/jpeg"
          },
          {
            "name": "attachments1",
            "isTemporary": false,
            "id": "ff808181963e296501963e29ac5e00bc",
            "contentType": "image/jpeg"
          }
        ],
        "customFields": [
          {
            "fieldDefinitionId": "2b965c866b634698811dabf45a491089,",
            "value": true
          }
        ],
        "description": "verification-description",
        "type": "ReceiptVerification",
        "lastUpdated": "2025-04-16T10:30:22Z",
        "dateCreated": "2025-04-16T10:30:22Z",
        "paymentTypeId": "253b87a3555a4c9bb288338131d2d83b",
        "exchangeRate": 1,
        "verificationNumber": "verification-number",
        "comment": "verification-comment",
        "currency": "SEK",
        "taxAmount": 23,
        "receiptAttachment": {
          "name": "file-name1011137852",
          "personId": "ff808181963e1df601963e26577201c2",
          "isTemporary": false,
          "id": "ff808181963e1df601963e26582601f8",
          "contentType": "image/png"
        },
        "representation": {
          "includesLiquor": false,
          "numberOfExternalGuests": 1,
          "guests": [],
          "numberOfGuests": 1,
          "type": "LUNCH",
          "guestListAttached": true,
          "guestListAttachment": {
            "name": "file-name386996737",
            "personId": "ff808181963e1df601963e26577201c2",
            "isTemporary": false,
            "id": "ff808181963e1df601963e26583101f9",
            "contentType": "application/pdf"
          }
        }
      }
    }
  },
  "receiptVerification with representation including attached guests": {
    "value": {
      "organizationId": "ff808181963e1df601963e1f931f014b",
      "lastUpdated": "2025-04-16T10:22:59Z",
      "dateCreated": "2025-04-16T10:22:59Z",
      "processStatus": "DRAFT",
      "personId": "ff808181963e1df601963e1f92d30121",
      "id": "7c50f82edb7747bdb84f038e535f1e7d",
      "reimbursementCurrency": "SEK",
      "categoryId": "ebde877306a94f66a9b0695c7c48a43d",
      "status": "NORMAL",
      "expenseDate": "2023-03-21T10:58:14Z",
      "verification": {
        "amount": 230,
        "purchaseDate": "2023-03-21T10:58:14Z",
        "attachments": [
          {
            "name": "attachments2",
            "isTemporary": false,
            "id": "ff808181963e296501963e29ac6d00be",
            "contentType": "image/jpeg"
          },
          {
            "name": "attachments1",
            "isTemporary": false,
            "id": "ff808181963e296501963e29ac5e00bc",
            "contentType": "image/jpeg"
          }
        ],
        "customFields": [
          {
            "fieldDefinitionId": "058d2a973694413db017b9e340f15d2d",
            "value": "2023-01-01T01:00:00Z"
          }
        ],
        "description": "verification-description",
        "type": "ReceiptVerification",
        "lastUpdated": "2025-04-16T10:22:59Z",
        "dateCreated": "2025-04-16T10:22:59Z",
        "paymentTypeId": "1f4d4253c7c740c7ae055d840d25392a",
        "exchangeRate": 1,
        "verificationNumber": "verification-number",
        "comment": "verification-comment",
        "currency": "SEK",
        "taxAmount": 23,
        "receiptAttachment": {
          "name": "file-name985238297",
          "personId": "ff808181963e1df601963e1f92d30121",
          "isTemporary": false,
          "id": "ff808181963e1df601963e1f93810157",
          "contentType": "image/png"
        },
        "representation": {
          "includesLiquor": false,
          "numberOfExternalGuests": 1,
          "type": "LUNCH",
          "guestListAttached": false,
          "guests": [
            {
              "name": "Person 1",
              "company": "Company A"
            },
            {
              "name": "Person 2",
              "company": "Company B"
            }
          ]
        }
      }
    }
  }
}

Authentication

Findity Expense API

Findity Admin API

Findity Admin API V0

Findity Connect API

Authorizations

Query Parameters

Body

Response