Introduction
Authentication
Webhooks
Changelog
Administration
Contacts
Custom fields
Document styles
Documents: General documents
Documents: General journal documents
Documents: Purchase invoices
Documents: Receipts
Documents: Typeless documents
Estimates
External sales invoices
Financial accounts
Financial mutations
Financial statements
Identities
Import mappings
Ledger accounts
Payments
Products
Projects
Purchase transactions
Recurring sales invoices
Sales invoices
Subscription templates
Subscriptions
Tax rates
Time entries
Users
Verifications
Webhooks
Workflows
List all subscription templates
GET
/subscription_templates(.:format)
This call retrieves a paginated list of all subscription templates available in the administration.
Each page consists of up to 100 subscription templates. To access subsequent pages, utilize the page parameter to fetch the next set of subscription templates.
Parameters
Parameter
Type
Description
page
Integer
Example: lists subscription templates for the administration
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/subscription_templates.json?
data = {}
RestClient . get (
"https://moneybird.com/api/v2/123/subscription_templates.json" , data ,
{ authorization: "Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" }
)
Response
Status: 200 OK
[
{
"id" : "433546362567525817" ,
"administration_id" : 123 ,
"workflow_id" : "433546362463716784" ,
"document_style_id" : "433546362412336558" ,
"mergeable" : false ,
"contact_can_update" : true ,
"products" : [
{
"id" : "433546362550748600" ,
"administration_id" : 123 ,
"description" : "fancy product" ,
"title" : null ,
"identifier" : null ,
"price" : "10.0" ,
"currency" : "EUR" ,
"frequency" : 1 ,
"frequency_type" : "month" ,
"tax_rate_id" : "433546362541311414" ,
"ledger_account_id" : "433546362546554295" ,
"created_at" : "2024-09-30T07:40:52.625Z" ,
"updated_at" : "2024-09-30T07:40:52.625Z"
}
]
}
]
Create online sales link
GET
/subscription_templates/:id/checkout_identifier(.:format)
This call generates an online sales link, which enables pre-setting the contact and start date for a subscription.
Parameters
Parameter
Type
Description
start_date
Date
Example: creates an online sales link
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/subscription_templates/433546363008976345/checkout_identifier.json?contact_id= 433546363016316380&start_date= 2024-09-30
data = { :contact_id => 433546363016316380 , :start_date => "2024-09-30" }
RestClient . get (
"https://moneybird.com/api/v2/123/subscription_templates/433546363008976345/checkout_identifier.json" , data ,
{ authorization: "Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" }
)
Response
Status: 200 OK
"http://checkout.moneybird.dev/s/NHJZZ1Fwc29ITzdrSHRQcWtUZFBrMGNUWUFzcEUraW02WmhGZTBwUlNJeEtmSWdqL2ZnNmtqb3Arc3dEQ0pHT1dPOVJXUlpvWE1xejRRTFEzUjBFWW1yWkxzWkdYaUZ1aXNURWQvRU5yMlZBWUFidS0tVlBjWGtQZ2NqSlByN04xZy0tR3hhZVQ5dDNCS1doVXgvMUkxcUdkZz09"