Mark approved expense claim as reimbursed (paid)

cURL

curl -sS -X POST "$FLUIDE_BASE_URL/api/v1/hr/expenses/claims/string/mark-paid" \
  -H "Authorization: Bearer $FLUIDE_ACCESS_TOKEN" \
  -H "X-Fluide-Api-Key: $FLUIDE_API_KEY" \
  -H "X-Fluide-Client-Id: fluide-developer" \
  -H "X-Workspace-Id: $FLUIDE_WORKSPACE_ID" \
  -H "X-Acting-Company-Id: $FLUIDE_COMPANY_ID" \
  -H "Content-Type: application/json" \
  -d '{}'

const baseUrl = process.env.FLUIDE_BASE_URL;

const response = await fetch(`${baseUrl}/api/v1/hr/expenses/claims/string/mark-paid`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.FLUIDE_ACCESS_TOKEN}`,
    'X-Fluide-Api-Key': process.env.FLUIDE_API_KEY,
    'X-Fluide-Client-Id': 'fluide-developer',
    'X-Workspace-Id': process.env.FLUIDE_WORKSPACE_ID,
    'X-Acting-Company-Id': process.env.FLUIDE_COMPANY_ID,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
console.log(await response.json());

import os
import requests

base_url = os.environ["FLUIDE_BASE_URL"]
headers = {
        "Authorization": f"Bearer {os.environ['FLUIDE_ACCESS_TOKEN']}",
        "X-Fluide-Api-Key": os.environ["FLUIDE_API_KEY"],
        "X-Fluide-Client-Id": "fluide-developer",
        "X-Workspace-Id": os.environ["FLUIDE_WORKSPACE_ID"],
        "X-Acting-Company-Id": os.environ["FLUIDE_COMPANY_ID"],
}

response = requests.post(
    f"{base_url}/api/v1/hr/expenses/claims/string/mark-paid",
    headers=headers,
    json={},
    timeout=30,
)
response.raise_for_status()
print(response.json())

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String baseUrl = System.getenv("FLUIDE_BASE_URL");
HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create(baseUrl + "/api/v1/hr/expenses/claims/string/mark-paid"))
    .header("Authorization", "Bearer " + System.getenv("FLUIDE_ACCESS_TOKEN"))
    .header("X-Fluide-Api-Key", System.getenv("FLUIDE_API_KEY"))
    .header("X-Fluide-Client-Id", "fluide-developer")
    .header("X-Workspace-Id", System.getenv("FLUIDE_WORKSPACE_ID"))
    .header("X-Acting-Company-Id", System.getenv("FLUIDE_COMPANY_ID"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{}"))
    .build();
HttpResponse<String> response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());
if (response.statusCode() >= 400) throw new RuntimeException("HTTP " + response.statusCode() + ": " + response.body());
System.out.println(response.body());

<?php
$baseUrl = getenv("FLUIDE_BASE_URL");
$ch = curl_init($baseUrl . "/api/v1/hr/expenses/claims/string/mark-paid");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('FLUIDE_ACCESS_TOKEN'),
        'X-Fluide-Api-Key: ' . getenv('FLUIDE_API_KEY'),
        'X-Fluide-Client-Id: fluide-developer',
        'X-Workspace-Id: ' . getenv('FLUIDE_WORKSPACE_ID'),
        'X-Acting-Company-Id: ' . getenv('FLUIDE_COMPANY_ID'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{}",
]);
$response = curl_exec($ch);
if ($response === false) throw new RuntimeException(curl_error($ch));
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status >= 400) throw new RuntimeException("HTTP $status: $response");
echo $response;

{
  "organizationId": "<string>",
  "companyId": "<string>",
  "hrEmployeeId": "<string>",
  "employee": {},
  "claimNumber": "<string>",
  "title": "<string>",
  "currency": "<string>",
  "totalAmount": 123,
  "submittedAt": "2023-11-07T05:31:56Z",
  "approvedAt": "2023-11-07T05:31:56Z",
  "paidAt": "2023-11-07T05:31:56Z",
  "notes": "<string>",
  "lines": [
    {
      "claimId": "<string>",
      "claim": "<unknown>",
      "expenseDate": "2023-11-07T05:31:56Z",
      "category": "<string>",
      "description": "<string>",
      "amount": 123,
      "receiptArtifactId": "<string>",
      "costCenterId": "<string>",
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "deletedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "deletedAt": "2023-11-07T05:31:56Z"
}

POST

api

expenses

claims

{id}

mark-paid

cURL

curl -sS -X POST "$FLUIDE_BASE_URL/api/v1/hr/expenses/claims/string/mark-paid" \
  -H "Authorization: Bearer $FLUIDE_ACCESS_TOKEN" \
  -H "X-Fluide-Api-Key: $FLUIDE_API_KEY" \
  -H "X-Fluide-Client-Id: fluide-developer" \
  -H "X-Workspace-Id: $FLUIDE_WORKSPACE_ID" \
  -H "X-Acting-Company-Id: $FLUIDE_COMPANY_ID" \
  -H "Content-Type: application/json" \
  -d '{}'

const baseUrl = process.env.FLUIDE_BASE_URL;

const response = await fetch(`${baseUrl}/api/v1/hr/expenses/claims/string/mark-paid`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.FLUIDE_ACCESS_TOKEN}`,
    'X-Fluide-Api-Key': process.env.FLUIDE_API_KEY,
    'X-Fluide-Client-Id': 'fluide-developer',
    'X-Workspace-Id': process.env.FLUIDE_WORKSPACE_ID,
    'X-Acting-Company-Id': process.env.FLUIDE_COMPANY_ID,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
console.log(await response.json());

import os
import requests

base_url = os.environ["FLUIDE_BASE_URL"]
headers = {
        "Authorization": f"Bearer {os.environ['FLUIDE_ACCESS_TOKEN']}",
        "X-Fluide-Api-Key": os.environ["FLUIDE_API_KEY"],
        "X-Fluide-Client-Id": "fluide-developer",
        "X-Workspace-Id": os.environ["FLUIDE_WORKSPACE_ID"],
        "X-Acting-Company-Id": os.environ["FLUIDE_COMPANY_ID"],
}

response = requests.post(
    f"{base_url}/api/v1/hr/expenses/claims/string/mark-paid",
    headers=headers,
    json={},
    timeout=30,
)
response.raise_for_status()
print(response.json())

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String baseUrl = System.getenv("FLUIDE_BASE_URL");
HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create(baseUrl + "/api/v1/hr/expenses/claims/string/mark-paid"))
    .header("Authorization", "Bearer " + System.getenv("FLUIDE_ACCESS_TOKEN"))
    .header("X-Fluide-Api-Key", System.getenv("FLUIDE_API_KEY"))
    .header("X-Fluide-Client-Id", "fluide-developer")
    .header("X-Workspace-Id", System.getenv("FLUIDE_WORKSPACE_ID"))
    .header("X-Acting-Company-Id", System.getenv("FLUIDE_COMPANY_ID"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{}"))
    .build();
HttpResponse<String> response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());
if (response.statusCode() >= 400) throw new RuntimeException("HTTP " + response.statusCode() + ": " + response.body());
System.out.println(response.body());

<?php
$baseUrl = getenv("FLUIDE_BASE_URL");
$ch = curl_init($baseUrl . "/api/v1/hr/expenses/claims/string/mark-paid");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('FLUIDE_ACCESS_TOKEN'),
        'X-Fluide-Api-Key: ' . getenv('FLUIDE_API_KEY'),
        'X-Fluide-Client-Id: fluide-developer',
        'X-Workspace-Id: ' . getenv('FLUIDE_WORKSPACE_ID'),
        'X-Acting-Company-Id: ' . getenv('FLUIDE_COMPANY_ID'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => "{}",
]);
$response = curl_exec($ch);
if ($response === false) throw new RuntimeException(curl_error($ch));
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status >= 400) throw new RuntimeException("HTTP $status: $response");
echo $response;

{
  "organizationId": "<string>",
  "companyId": "<string>",
  "hrEmployeeId": "<string>",
  "employee": {},
  "claimNumber": "<string>",
  "title": "<string>",
  "currency": "<string>",
  "totalAmount": 123,
  "submittedAt": "2023-11-07T05:31:56Z",
  "approvedAt": "2023-11-07T05:31:56Z",
  "paidAt": "2023-11-07T05:31:56Z",
  "notes": "<string>",
  "lines": [
    {
      "claimId": "<string>",
      "claim": "<unknown>",
      "expenseDate": "2023-11-07T05:31:56Z",
      "category": "<string>",
      "description": "<string>",
      "amount": 123,
      "receiptArtifactId": "<string>",
      "costCenterId": "<string>",
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "deletedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "deletedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Access token JWT. Use as Authorization: Bearer . In the API playground, paste the JWT only.

X-Fluide-Api-Key

string

header

default:fl_dev_your_key

required

Developer API key (fl_dev_...). Required on every API call with a machine access token.

X-Fluide-Client-Id

string

header

default:fluide-developer

required

First-party client audience. Must match the fluide_client_id claim on the JWT. Use fluide-developer for Connect.

Headers

X-Workspace-Id

string<uuid>

Partner / ISV only: UUID of the workspace that owns the client company. Required together with X-Acting-Company-Id when scoping product APIs to a merchant. See /getting-started/multi-tenancy.

X-Acting-Company-Id

string<uuid>

Partner / ISV only: UUID of the client company to act on. Must belong to the workspace in X-Workspace-Id.

Path Parameters

string

required

Body

application/json

paidAt

string

ISO date; defaults to now

paymentReference

string

Payroll run id, bank transfer ref, etc.

notes

string

Response

201 - application/json

organizationId

string

required

companyId

string

required

hrEmployeeId

string

required

employee

object

required

claimNumber

string

required

title

string

required

currency

string

required

totalAmount

number

required

status

enum<string>

required

Available options:

DRAFT,

SUBMITTED,

APPROVED,

REJECTED,

PAID,

CANCELLED

submittedAt

string<date-time> | null

required

approvedAt

string<date-time> | null

required

paidAt

string<date-time> | null

required

notes

string | null

required

lines

object[]

required

Show child attributes

string

required

createdAt

string<date-time>

required

updatedAt

string<date-time>

required

deletedAt

string<date-time>

Auth API

HR API

Payroll API

Pay API

Books API

Utils API

Mark approved expense claim as reimbursed (paid)

Authorizations

Headers

Path Parameters

Body

Response