Retrieve a version of an automation rule
Retrieve one frozen version of the definition of a rule by its version number — an ordinal, not a UUID. Unlike the listing, an unknown pair of rule and version returns 404. A version keeps resolving after its rule has been deleted, which is what lets the detail of an old run explain the definition it started from.
Request
- Base URL: https://api.factuarea.com/v1
- URL: https://api.factuarea.com/v1/companies/{company}/automations/rules/{rule}/versions/{version}
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Path parameters
Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).
Public identifier (UUID v7) of the automation rule.
Version number (integer) of the rule, as returned in version by its versions list.
Headers
Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.
Response
Example response
{
"data": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a62",
"automation_rule_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a61",
"version": 2,
"trigger_type": "invoice.paid",
"conditions": {
"field": "total",
"operator": "gte",
"value": 1000
},
"actions": [
{
"type": "notify_in_app",
"order": 0,
"parameters": {
"recipient_type": "role",
"role": "admin",
"category": "invoice",
"title": "Cobro grande",
"message": "Se ha cobrado una factura de 1000 EUR o más."
}
}
],
"created_at": "2026-03-16T09:30:00Z"
}
}Changes
No recorded changes to this operation across all 1 revision of this API.