List follow-up stages

GET/api/v2/follow-ups/stages

Returns your follow-up stages in order, with how long after the last message each one is due. When your organization has more than one follow-up board, stages are grouped under data.boards.

Rate limit 150 requests per minute

Headers

  • x-api-keyheaderRequired

    Your API key.

  • Content-Typeheader

    application/json. Not needed for this request.

Query parameters

  • statusstring

    active (default), archived or all.

Errors

ErrorWhen
400invalid_status
status is not active, archived or all.
Request
curl "https://app.dmtracker.ai/api/v2/follow-ups/stages" \
  -H "x-api-key: $DMTRACKER_API_KEY" \
  -H "Content-Type: application/json"
Response 200 · One board.
{
  "status": "success",
  "data": {
    "stages": [
      {
        "id": "4d8b2f6e-1a3c-4e9b-8f70-6c2a5e9d1b38",
        "name": "1st follow-up",
        "index": 0,
        "due_after_seconds": 43200,
        "status": "active",
        "created_at": "2025-09-09T05:35:58.573+00:00"
      },
      {
        "id": "8f3a1d7c-6e5b-4b2a-9d04-1c7e3a8f5b62",
        "name": "2nd follow-up",
        "index": 1,
        "due_after_seconds": 259200,
        "status": "active",
        "created_at": "2025-09-09T05:35:58.573+00:00"
      },
      {
        "id": "0b6e4c9a-3f8d-4e17-a2c5-7d1b9e0f4a83",
        "name": "3rd follow-up",
        "index": 2,
        "due_after_seconds": 604800,
        "status": "active",
        "created_at": "2025-09-09T05:35:58.573+00:00"
      }
    ]
  },
  "total_stages": 3
}
Response 200 · More than one board.
{
  "status": "success",
  "data": {
    "boards": [
      {
        "id": 12,
        "name": "Ongoing Conversations",
        "type": "ongoing",
        "created_at": "2025-08-05T15:19:48.032+00:00",
        "stages": [
          {
            "id": "4d8b2f6e-1a3c-4e9b-8f70-6c2a5e9d1b38",
            "name": "1st follow-up",
            "index": 0,
            "due_after_seconds": 43200,
            "status": "active",
            "created_at": "2025-09-09T05:35:58.573+00:00"
          },
          {
            "id": "8f3a1d7c-6e5b-4b2a-9d04-1c7e3a8f5b62",
            "name": "2nd follow-up",
            "index": 1,
            "due_after_seconds": 259200,
            "status": "active",
            "created_at": "2025-09-09T05:35:58.573+00:00"
          }
        ]
      },
      {
        "id": 13,
        "name": "Unanswered Outbound",
        "type": "outbound",
        "created_at": "2025-08-05T15:19:48.032+00:00",
        "stages": [
          {
            "id": "0b6e4c9a-3f8d-4e17-a2c5-7d1b9e0f4a83",
            "name": "3rd follow-up",
            "index": 2,
            "due_after_seconds": 604800,
            "status": "active",
            "created_at": "2025-09-09T05:35:58.573+00:00"
          }
        ]
      }
    ]
  },
  "total_boards": 2,
  "total_stages": 3
}
Link copied