---
title: "Get template recipients"
url: "https://docs.signnow.com/docs/template/operations/get-template-routing-details"
type: "endpoint"
section: "template"
slug: "template/operations/get-template-routing-details"
method: "GET"
path: "/document/{template_id}/template/routing/detail"
operation_id: "get-template-routing-details"
authorization: "bearer"
---

# Get template recipients

`GET /document/{template_id}/template/routing/detail`

This endpoint allows API users to retrieve detailed routing information for a template, including signers, viewers, approvers, and CC recipients, along with their specific roles and signing order.

## Authorization

bearer

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `template_id` | string | Yes | Template ID. |

## Responses

### 200

OK

**Example** (`Response with no routing details`)

```json
{}
```

**Example** (`Response with empty routing details`)

```json
{
  "cc": [],
  "cc_step": [],
  "viewers": [],
  "routing_details": [],
  "invite_link_instructions": ""
}
```

**Example** (`Successful response with routing details`)

```json
{
  "cc": [
    "manager@example.com",
    "hr.department@example.com"
  ],
  "cc_step": [
    {
      "name": "Compliance Team",
      "step": 1,
      "email": "compliance@example.com"
    },
    {
      "name": "Records Keeping",
      "step": 2,
      "email": "records@example.com"
    }
  ],
  "viewers": [
    {
      "name": "Legal Observer",
      "contact_id": "1234567890abcdef1234567890abcdef12345678",
      "inviter_role": false,
      "default_email": "legal.observer@example.com",
      "signing_order": 1
    },
    {
      "name": "External Auditor",
      "default_email": "auditor@example.com",
      "signing_order": 2
    }
  ],
  "approvers": [
    {
      "name": "Director of Sales",
      "inviter_role": false,
      "default_email": "director@example.com",
      "signing_order": 3,
      "authentication": null,
      "expiration_days": 15
    },
    {
      "name": "VP Finance",
      "default_email": "vp.finance@example.com",
      "signing_order": 4,
      "authentication": null
    }
  ],
  "attributes": {
    "brand_id": "99887766554433221100aabbccddeeff11223344",
    "on_complete": "redirect",
    "redirect_uri": "https://example.com/thank-you"
  },
  "routing_details": [
    {
      "name": "John Smith",
      "role_id": "a1b2c3d4e5f67890123456789abcdef012345678",
      "inviter_role": false,
      "default_email": "john.smith@example.com",
      "signing_order": 1
    },
    {
      "name": "Alice Johnson",
      "role_id": "f0e9d8c7b6a543210987654321fedcba09876543",
      "inviter_role": false,
      "default_email": "alice.johnson@example.com",
      "signing_order": 2
    }
  ],
  "invite_link_instructions": "Please review the attached contract details before signing."
}
```

### 400

- Document not found.


**Example** (`Example 1`)

```json
{
  "errors": [
    {
      "code": 65582,
      "message": "Document not found"
    }
  ]
}
```

## Code Examples

> Replace `$SIGNNOW_ACCESS_TOKEN` and any `{placeholder}` values before running.

### cURL

```bash
curl -X GET \
  "https://api.signnow.com/document/{template_id}/template/routing/detail" \
  -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN"
```

---
*Full reference: https://docs.signnow.com/docs/template/operations/get-template-routing-details*