Get logged in user

This endpoint contains personal information like email, first name, last name, etc. The person object is the same for all organizations the user is connected to. The data in this resource is owned by the person unless the partner is the master of the personal information and has synced the persons before hand (See Findity Expense Admin API for more information). While the user is being impersonated, the impersonated user is returned (the same person that PUT /me updates), and meta.impersonatedPerson and meta.impersonator identify both people.

GET

Get logged in user

curl --request GET \
  --url https://stage-api.findity.com/api/v1/expense/me \
  --header 'Authorization: Bearer <token>'

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

fetch('https://stage-api.findity.com/api/v1/expense/me', 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",
  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"

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

}

require 'uri'
require 'net/http'

url = URI("https://stage-api.findity.com/api/v1/expense/me")

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

{
  "id": "370e10197a2740dea1f39d21bc9e4a8c",
  "email": "emma.expense@example.com",
  "firstName": "Emma",
  "lastName": "Expense",
  "mobilePhone": "+4670123456789",
  "defaultCurrency": "USD",
  "language": "en_US",
  "IBAN": "US2138890474392778363181",
  "BIC": "ABCDEF123",
  "address": {
    "id": "2ee7643987df40b38537b32ccda585d9",
    "street1": "132, My Street",
    "postalCode": "12401",
    "city": "New York",
    "countryCode": "US"
  },
  "formattingRegion": "sv_SE",
  "meta": {
    "capabilities": {
      "canImpersonate": false,
      "canViewAdmin": false
    },
    "impersonatedPerson": {
      "id": "370e10197a2740dea1f39d21bc9e4a8c",
      "firstName": "Emma",
      "lastName": "Expense",
      "profileImageUrl": "https://api.findity.com/api/v1/expense/profileimage/370e10197a2740dea1f39d21bc9e4a8c?signature=..."
    },
    "impersonator": {
      "id": "8b1c2d3e4f5a46b7c8d9e0f1a2b3c4d5",
      "firstName": "Erik",
      "lastName": "Admin"
    }
  }
}

{
  "result": "unauthorized"
}

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:

preferences,

extraRecipients,

meta.capabilities,

temporaryApprovers

Response

string

UUID without dashes (32-character hex string)

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

string

read-only

extraRecipients

object[]

read-only

Hide child attributes

extraRecipients.email

string

extraRecipients.status

enum<string>

Available options:

CONFIRMED,

NOT_CONFIRMED

firstName

string

Given name.

lastName

string

Family name.

mobilePhone

string

read-only

defaultCurrency

string

Default currency for new expenses (ISO 4217 code).

bankAccountNumber

string

User's bank account number for reimbursements.

language

string

Preferred UI language as a locale code (e.g. en_GB, sv_SE).

IBAN

string

International Bank Account Number for cross-border reimbursements.

BIC

string

Bank Identifier Code (SWIFT) for cross-border reimbursements.

address

object

User's address.

Hide child attributes

address.id

string

UUID without dashes (32-character hex string)

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

address.street1

string

address.postalCode

string

address.city

string

address.countryCode

string

Example:

{
  "id": "2ee7643987df40b38537b32ccda585d9",
  "street1": "132, My Street",
  "postalCode": "12401",
  "city": "New York",
  "countryCode": "US"
}

preferences

object

Per-user UI/notification preferences.

Hide child attributes

preferences.dateDisplayType

enum<string>

Available options:

TIMESTAMP,

TIME_AGO

preferences.calculateTaxAmount

boolean

preferences.useOCR

boolean

preferences.suppressAnalyzeInfoDialog

boolean

formattingRegion

string

The region/locale used for formatting dates/numbers

temporaryApprovers

object[]

A list of temporary approvers that user has set

Hide child attributes

temporaryApprovers.organizationId

string

Id of organization for which user has chose to set temporary approver for

temporaryApprovers.temporaryApproverPersonId

string

Id of person which current user has chosen to act to perform approver role temporarily in his place

temporaryApprovers.fromDate

string

Start date from which added person will act as approver. This value is set/delivered in format "yyyy-MM-dd'T'HH:mm'Z'"

temporaryApprovers.toDate

string

End date when added person will be stopped to act as temporary approver instead of current user. This value is set/delivered in format "yyyy-MM-dd'T'HH:mm'Z'"

temporaryApprovers.approverId

string

Unique id assigned to added temporary user which is created within our system.

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

meta

object

Response-only. Server-populated capability flags and derived fields for the user.

Hide child attributes

meta.capabilities

object

Hide child attributes

meta.capabilities.canImpersonate

boolean

Indicates if the currently logged in user can act as some other user

Example:

false

meta.capabilities.canViewAdmin

boolean

Indicates if the current user has an access to the admin part of the system or not

Example:

true

meta.capabilities.canViewSettings

boolean

Indicates if the current user has an access to the settings part of the system or not

Example:

true

meta.impersonatedPerson

object

Only present while the user is being impersonated. The impersonated user, i.e. the person this resource describes.

Hide child attributes

meta.impersonatedPerson.id

string

UUID without dashes (32-character hex string)

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

meta.impersonatedPerson.firstName

string

meta.impersonatedPerson.lastName

string

meta.impersonatedPerson.profileImageUrl

string<uri>

Pre-signed URL to the impersonated user's profile image.

meta.impersonator

object

Only present while the user is being impersonated. The person who is impersonating the user.

Hide child attributes

meta.impersonator.id

string

UUID without dashes (32-character hex string)

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

meta.impersonator.firstName

string

meta.impersonator.lastName

string

⌘I

Get logged in user

curl --request GET \
  --url https://stage-api.findity.com/api/v1/expense/me \
  --header 'Authorization: Bearer <token>'

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

fetch('https://stage-api.findity.com/api/v1/expense/me', 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",
  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"

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

}

require 'uri'
require 'net/http'

url = URI("https://stage-api.findity.com/api/v1/expense/me")

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

{
  "id": "370e10197a2740dea1f39d21bc9e4a8c",
  "email": "emma.expense@example.com",
  "firstName": "Emma",
  "lastName": "Expense",
  "mobilePhone": "+4670123456789",
  "defaultCurrency": "USD",
  "language": "en_US",
  "IBAN": "US2138890474392778363181",
  "BIC": "ABCDEF123",
  "address": {
    "id": "2ee7643987df40b38537b32ccda585d9",
    "street1": "132, My Street",
    "postalCode": "12401",
    "city": "New York",
    "countryCode": "US"
  },
  "formattingRegion": "sv_SE",
  "meta": {
    "capabilities": {
      "canImpersonate": false,
      "canViewAdmin": false
    },
    "impersonatedPerson": {
      "id": "370e10197a2740dea1f39d21bc9e4a8c",
      "firstName": "Emma",
      "lastName": "Expense",
      "profileImageUrl": "https://api.findity.com/api/v1/expense/profileimage/370e10197a2740dea1f39d21bc9e4a8c?signature=..."
    },
    "impersonator": {
      "id": "8b1c2d3e4f5a46b7c8d9e0f1a2b3c4d5",
      "firstName": "Erik",
      "lastName": "Admin"
    }
  }
}

{
  "result": "unauthorized"
}

Authentication

Findity Expense API

Findity Admin API

Findity Admin API V0

Findity Connect API

Get logged in user

Authorizations

Query Parameters

Response