Transfers

List Transfers

Retrieve a paginated list of transfer rules. Returns transfer data including label, method, destination, conditions, and settings. Results are filtered by the organization associated with the API key.

GET
/v1/transfers

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer token authentication for API access.

In: header

Query Parameters

page?integer

Page number for pagination

Default1
Range1 <= value
limit?integer

Number of items per page (max 100)

Default50
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

curl -X GET "https://api.sophiie.ai/v1/transfers"
{
  "transfers": [
    {
      "id": 7,
      "label": "Sales Department Transfer",
      "name": "Sales Team",
      "method": "WARM",
      "destinationType": "DEPARTMENT",
      "destination": "dep_sales_01",
      "conditions": "When the customer asks to speak with a sales representative.",
      "summaryFormat": "Customer {name} is calling about {topic}. Key details: {summary}.",
      "settings": {
        "ignore_business_hours": false
      },
      "isEnabled": true,
      "scenarioId": null,
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-01-20T14:00:00.000Z"
    }
  ],
  "totalPages": 2,
  "currentPage": 1,
  "totalCount": 15
}
{
  "success": false,
  "message": "Invalid or expired token",
  "error": {
    "status": 401,
    "message": "Invalid or expired token"
  }
}
{
  "success": false,
  "message": "Internal server error",
  "error": {
    "status": 500,
    "message": "Internal server error"
  }
}