Skip to main content
GET
/
api
/
lines
/
by-user
Get All Lines
curl --request GET \
  --url https://app.tuco.ai/api/lines/by-user \
  --header 'Authorization: Bearer <token>'
Returns every line for the workspace with usage (new conversations and total messages for today) and health status. Use the line _id as fromLineId when sending messages, or omit it for round-robin.

​
Endpoint

  • Method: GET
  • Path: /api/lines/by-user
  • Auth: Authorization: Bearer tuco_sk_xxxxxxxxxxxxx

​
Example request

GET https://app.tuco.ai/api/lines/by-user
Authorization: Bearer tuco_sk_xxxxxxxxxxxxx

​
Success response (200)

{
  "lines": [
    {
      "_id": "699f704bc405fae6ca299a08",
      "workspaceId": "org_3ABCDbdGyF6w99hikyVN4cmo6H0",
      "phone": "+16462230920",
      "email": "goforlisa@icloud.com",
      "firstName": "Lindsey",
      "lastName": "Rodriguez",
      "isActive": true,
      "provisioningStatus": "active",
      "lineType": "byon",
      "dailyNewConversationsLimit": 20,
      "dailyTotalMessagesLimit": 50,
      "usage": {
        "date": "2026-03-01",
        "newConversationsCount": 4,
        "totalMessagesCount": 11
      },
      "healthCheck": {
        "status": "healthy",
        "lastCheckedAt": "2026-03-01T20:52:00.097Z"
      },
      "createdAt": "2026-02-25T21:57:31.276Z",
      "updatedAt": "2026-03-01T20:52:04.622Z"
    }
  ]
}

​
Error responses

StatusWhenBody
400No active workspace{ "error": "No active workspace" }
401Missing or invalid API key{ "error": "Unauthorized" }
500Server error{ "error": "Internal server error" }
Use the Try it panel to run this request interactively.