Get All Follow-Up Statuses by type

Production

https://{{subdomain}}.daftra.com/api2

GET

/follow_up_statuses/{type}{format}

Returns every follow-up status defined for a given item type — the stages a record (client, invoice, work order, …) can move through. Requires the Edit Client Settings permission. Statuses are returned in their configured display order.

The {type} path segment selects which item type's statuses to return and must be one of the supported values:

Value	Item type
`client`	Clients
`invoice`	Invoices
`estimate`	Estimates
`purchase_order`	Purchase orders
`staff`	Staff
`supplier`	Suppliers
`product`	Products
`work_order`	Work orders

Any other value returns 404.

Request

Path Params

Query Params

Header Params

Responses

🟢200OK

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://.daftra.com/api2/follow_up_statuses/client.json' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Content-Type: application/json'

Response Example

200 - Example 1

{
    "result": "successful",
    "code": 200,
    "data": [
        {
            "FollowUpStatus": {
                "id": 31,
                "site_id": 100,
                "item_type": 1,
                "name": "New Lead",
                "color": "white",
                "status": 1,
                "display_order": 1,
                "is_primary": 0,
                "require_followup": 0,
                "followup_after": 3,
                "entity_key": null,
                "deleted": 0,
                "created": "2021-02-01 10:00:00",
                "modified": "2021-02-01 10:00:00"
            }
        }
    ],
    "pagination": {
        "prev": null,
        "next": null,
        "page": 1,
        "page_count": 1,
        "total_results": 5
    }
}

Delete Follow-Up Status

Get All Follow-Up Actions