Accounting API Instalments

Update an instalment plan

POST https://api.tamio.com/v2/instalments/update/{uuid}

Updates an existing instalment plan with new payment schedule and terms.

The interval field maximum depends on the cycle value:

day → max interval 365
week → max interval 52
month → max interval 12
year → max interval 1

Path Parameters

uuid string*

UUID of the instalment plan to update

Body Parameters

label string*

Display name for the instalment plan

interval integer*

Number of cycle units between payments. Maximum depends on the cycle value: day=365, week=52, month=12, year=1.

instalments integer*

Total number of instalment payments

cycle string*

Time unit for payment intervals

dayweekmonthyear

upfront number

Percentage of total amount to pay upfront (0-90%)

interest number

Interest rate percentage applied to instalments (0-100%)

countries array of string

Array of country codes where this instalment plan is available

active boolean

Whether the instalment plan is active

Responses

200 Instalment plan updated successfully

Instalment plan updated successfully

status integer

instalment_plan InstalmentPlan

400 Bad request. Possible `error_code` values:

Bad request. Possible error_code values:

Code	Description
`1002`	ResourceNotFound

status integer

error string

Human-readable error message

error_code integer

Machine-readable error code

401 Missing or invalid API key

Create an instalment plan

Retrieve an instalment plan

/instalments/update/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/instalments/update/{uuid}", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     // ... request body
9   })
10 });
11 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/instalments/update/{uuid}")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Post.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 request["Content-Type"] = "application/json"
13 request.body = %Q{
14   // ... request body
15 }
16 
17 response = https.request(request)
18 puts response.read_body

Responses

{
  "status": 200,
  "instalment_plan": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "object": "instalment_plan",
    "label": "Monthly 3x Plan",
    "interval": 1,
    "billing_cycle": "month",
    "upfront": 10,
    "interest": 5,
    "instalments": 3,
    "countries": [
      "de",
      "fr",
      "us"
    ],
    "sales": 15,
    "active": true,
    "created_at": 1700000000
  }
}

1	const response = await fetch("https://api.tamio.com/v2/instalments/update/{uuid}", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	// ... request body
9	})
10	});
11	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/instalments/update/{uuid}")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Post.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12	request["Content-Type"] = "application/json"
13	request.body = %Q{
14	// ... request body
15	}
16
17	response = https.request(request)
18	puts response.read_body