Subscription templates

cURL Ruby

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
`per_page`	`Integer`
`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?
    
    

Response

        
          
          Status: 200 OK

[
  {
    "id": "446241820607776351",
    "administration_id": 123,
    "workflow_id": "446241820583659095",
    "document_style_id": "446241820554298966",
    "mergeable": false,
    "contact_can_update": true,
    "products": [
      {
        "id": "446241820600436318",
        "administration_id": 123,
        "description": "fancy product",
        "title": null,
        "identifier": null,
        "price": "10.0",
        "currency": "EUR",
        "frequency": 1,
        "frequency_type": "month",
        "tax_rate_id": "446241820592047708",
        "ledger_account_id": "446241820596242013",
        "created_at": "2025-02-17T10:49:44.933Z",
        "updated_at": "2025-02-17T10:49:44.933Z"
      }
    ]
  }
]

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/446241820894037627/checkout_identifier.json?contact_id=446241820898231934&start_date=2025-02-17
    
    

Response

        
          
          Status: 200 OK

"http://checkout.moneybird.dev/s/SDByb3NCb1hmUU5xbmI2bmdZdE50UkRNRWRnYzJDT3ladUVreTdNNlFUN09CTVplYTNVR3dWempVYk51RjNJVWNrOW54a3dCOE0walR5WW5ZdVFtWjBFanhHdkZWSFY5K0swSDd6dEpZTnVmUUxscS0tczZPZkxyMkx0M3NEYmhMVy0tZkJRL280c0hQeVZNbnNCbHhYKzNHUT09"