Skip to main content
POST
/
accounting
/
transactions
cURL
curl --request POST \
  --url https://api.maesn.dev/accounting/transactions \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --form 'files=<string>' \
  --form 'transaction={
  "accountId": "14a6b5e92-a261-4be9-814d-84dec9636c16",
  "accountNumber": 4900,
  "amount": 100,
  "bookingDate": "2025-07-15T00:00:00Z",
  "contact": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "currency": "EUR",
  "description": "Hotel for dreamforce",
  "journalCode": "31",
  "ledgerName": "Payroll",
  "reference": "RCXF197253F",
  "taxRatePercentage": 19,
  "type": "SPEND",
  "valueDate": "2025-07-15T00:00:00Z"
}' \
  --form files.items='@example-file'
import requests

url = "https://api.maesn.dev/accounting/transactions"

files = { "files.items": ("example-file", open("example-file", "rb")) }
payload = {
    "files": "<string>",
    "transaction": "{
  \"accountId\": \"14a6b5e92-a261-4be9-814d-84dec9636c16\",
  \"accountNumber\": 4900,
  \"amount\": 100,
  \"bookingDate\": \"2025-07-15T00:00:00Z\",
  \"contact\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",
  \"currency\": \"EUR\",
  \"description\": \"Hotel for dreamforce\",
  \"journalCode\": \"31\",
  \"ledgerName\": \"Payroll\",
  \"reference\": \"RCXF197253F\",
  \"taxRatePercentage\": 19,
  \"type\": \"SPEND\",
  \"valueDate\": \"2025-07-15T00:00:00Z\"
}"
}
headers = {
    "X-API-KEY": "<x-api-key>",
    "X-ACCOUNT-KEY": "<x-account-key>"
}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)
const form = new FormData();
form.append('files', '<string>');
form.append('transaction', '{
  "accountId": "14a6b5e92-a261-4be9-814d-84dec9636c16",
  "accountNumber": 4900,
  "amount": 100,
  "bookingDate": "2025-07-15T00:00:00Z",
  "contact": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "currency": "EUR",
  "description": "Hotel for dreamforce",
  "journalCode": "31",
  "ledgerName": "Payroll",
  "reference": "RCXF197253F",
  "taxRatePercentage": 19,
  "type": "SPEND",
  "valueDate": "2025-07-15T00:00:00Z"
}');
form.append('files.items', '{
  "fileName": "example-file"
}');

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<x-api-key>', 'X-ACCOUNT-KEY': '<x-account-key>'}
};

options.body = form;

fetch('https://api.maesn.dev/accounting/transactions', 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://api.maesn.dev/accounting/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"transaction\"\r\n\r\n{\r\n  \"accountId\": \"14a6b5e92-a261-4be9-814d-84dec9636c16\",\r\n  \"accountNumber\": 4900,\r\n  \"amount\": 100,\r\n  \"bookingDate\": \"2025-07-15T00:00:00Z\",\r\n  \"contact\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n  \"currency\": \"EUR\",\r\n  \"description\": \"Hotel for dreamforce\",\r\n  \"journalCode\": \"31\",\r\n  \"ledgerName\": \"Payroll\",\r\n  \"reference\": \"RCXF197253F\",\r\n  \"taxRatePercentage\": 19,\r\n  \"type\": \"SPEND\",\r\n  \"valueDate\": \"2025-07-15T00:00:00Z\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "X-ACCOUNT-KEY: <x-account-key>",
    "X-API-KEY: <x-api-key>"
  ],
]);

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

curl_close($curl);

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

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

func main() {

	url := "https://api.maesn.dev/accounting/transactions"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"transaction\"\r\n\r\n{\r\n  \"accountId\": \"14a6b5e92-a261-4be9-814d-84dec9636c16\",\r\n  \"accountNumber\": 4900,\r\n  \"amount\": 100,\r\n  \"bookingDate\": \"2025-07-15T00:00:00Z\",\r\n  \"contact\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n  \"currency\": \"EUR\",\r\n  \"description\": \"Hotel for dreamforce\",\r\n  \"journalCode\": \"31\",\r\n  \"ledgerName\": \"Payroll\",\r\n  \"reference\": \"RCXF197253F\",\r\n  \"taxRatePercentage\": 19,\r\n  \"type\": \"SPEND\",\r\n  \"valueDate\": \"2025-07-15T00:00:00Z\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<x-api-key>")
	req.Header.Add("X-ACCOUNT-KEY", "<x-account-key>")

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

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

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.maesn.dev/accounting/transactions")
  .header("X-API-KEY", "<x-api-key>")
  .header("X-ACCOUNT-KEY", "<x-account-key>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"transaction\"\r\n\r\n{\r\n  \"accountId\": \"14a6b5e92-a261-4be9-814d-84dec9636c16\",\r\n  \"accountNumber\": 4900,\r\n  \"amount\": 100,\r\n  \"bookingDate\": \"2025-07-15T00:00:00Z\",\r\n  \"contact\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n  \"currency\": \"EUR\",\r\n  \"description\": \"Hotel for dreamforce\",\r\n  \"journalCode\": \"31\",\r\n  \"ledgerName\": \"Payroll\",\r\n  \"reference\": \"RCXF197253F\",\r\n  \"taxRatePercentage\": 19,\r\n  \"type\": \"SPEND\",\r\n  \"valueDate\": \"2025-07-15T00:00:00Z\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.maesn.dev/accounting/transactions")

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

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"transaction\"\r\n\r\n{\r\n  \"accountId\": \"14a6b5e92-a261-4be9-814d-84dec9636c16\",\r\n  \"accountNumber\": 4900,\r\n  \"amount\": 100,\r\n  \"bookingDate\": \"2025-07-15T00:00:00Z\",\r\n  \"contact\": \"eaa28f49-6028-4b6e-bb12-d8f6278073fc\",\r\n  \"currency\": \"EUR\",\r\n  \"description\": \"Hotel for dreamforce\",\r\n  \"journalCode\": \"31\",\r\n  \"ledgerName\": \"Payroll\",\r\n  \"reference\": \"RCXF197253F\",\r\n  \"taxRatePercentage\": 19,\r\n  \"type\": \"SPEND\",\r\n  \"valueDate\": \"2025-07-15T00:00:00Z\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": {
    "id": "f733a433-9662-4a40-8e36-e38ebda94fe1",
    "accountId": "14a6b5e92-a261-4be9-814d-84dec9636c16",
    "accountNumber": 4900,
    "amount": 100,
    "bookingDate": "2025-07-15T00:00:00Z",
    "contact": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "currency": "EUR",
    "description": "Hotel for dreamforce",
    "files": [
      "file1.pdf"
    ],
    "journalCode": "31",
    "ledgerName": "Payroll",
    "reference": "RCXF197253F",
    "status": "CREATED",
    "taskId": "ADB4457839PXTC2220",
    "taxRatePercentage": 19,
    "type": "SPEND",
    "valueDate": "2025-07-15T00:00:00Z"
  }
}

​
Field support per integration

This endpoints is asynchronous. To check the status of the request, use the GET asyncTask endpoint. For more info about asynchronous tasks visit the Asynchronous Task section.
If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is accurately populated with the appropriate company ID. You can obtain this value by using the GET Companies endpoint available under the Authentication section.
Supported request parameters:
​
transaction
string
required
​
files
file[]
If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section.
Supported request parameters:
​
transaction
string
required
Supported request fields:
​
transaction
string
required
Supported request fields:
​
transaction
string
required

Headers

​
X-API-KEY
string
required

API key

​
X-ACCOUNT-KEY
string
required

Account key

Query Parameters

​
companyId
string
​
journalCode
string

Body

multipart/form-data
​
files
file[]

Array of files to upload

​
transaction
object

Response

200 - application/json
​
meta
object
​
data
object
Last modified on July 9, 2026