> ## Documentation Index
> Fetch the complete documentation index at: https://docs.routera.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get router

> GET /routers/{routerId} — retrieve a single router

## Endpoint

```http theme={null}
GET https://api.routera.io/routers/{routerId}
```

**Route:** `/routers/{routerId}`\
**Authentication:** Bearer JWT

## Path parameters

| Parameter  | Required | Description |
| ---------- | -------- | ----------- |
| `routerId` | Yes      | Router UUID |

## Response

**200** — Router object (same shape as list items)

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Contact Router",
  "object_type": "contacts",
  "has_integration": true,
  "is_published": true,
  "archived": false,
  "created_at": "2026-05-01T10:00:00.000Z",
  "updated_at": "2026-05-28T12:00:00.000Z",
  "settings": {
    "overwrite": true,
    "owner_field": "contact_owner",
    "distribution_model": "round robin",
    "default_user": "developer@test.com",
    "disable_default_assignment": false,
    "ignore_working_hours": true,
    "account_matching": true,
    "trigger": {
      "groups": [
        {
          "conditions": []
        }
      ]
    }
  },
  "users": [
    {
      "email": "user@example.com"
    }
  ],
  "teams": [
    {
      "name": "Sales Team"
    }
  ]
}
```

### Settings mapping

| Setting key                  | API value                                   |
| ---------------------------- | ------------------------------------------- |
| `overwrite`                  | boolean                                     |
| `owner_field`                | field internal name string                  |
| `distribution_model`         | `"round robin"` or `"percentage"`           |
| `default_user`               | backup user email                           |
| `disable_default_assignment` | boolean                                     |
| `ignore_working_hours`       | boolean                                     |
| `account_matching`           | boolean                                     |
| `rotation_type`              | string                                      |
| `trigger`                    | JSON object (only setting returned as JSON) |

## Errors

| Status | When                                       |
| ------ | ------------------------------------------ |
| `400`  | Invalid or missing `routerId` (not a UUID) |
| `401`  | Missing or invalid account context in JWT  |
| `404`  | Router not found for this account          |
| `500`  | Internal server error                      |


## OpenAPI

````yaml GET /routers/{routerId}
openapi: 3.0.1
info:
  title: Routera API
  description: >-
    Routera v2 REST API. Objects CRUD for contacts, companies, deals, and
    tickets, routers read API, plus router dispatch.
  version: 1.0.0
servers:
  - url: https://api.routera.io
    description: >-
      API Gateway base URL (override with ROUTERA_API_BASE_URL when generating
      docs)
security: []
tags:
  - name: Authentication
    description: Access token issuance
  - name: Contacts
    description: Contact records
  - name: Companies
    description: Company records
  - name: Deals
    description: Deal records
  - name: Tickets
    description: Ticket records
  - name: Routers
    description: Router configuration
  - name: Dispatch
    description: Router assignment
paths:
  /routers/{routerId}:
    get:
      tags:
        - Routers
      summary: Get router by id
      operationId: getRouterById
      parameters:
        - name: routerId
          in: path
          required: true
          description: Object identifier
          schema:
            type: string
      responses:
        '200':
          description: Router
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Router'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
      security:
        - bearerAuth: []
components:
  schemas:
    Router:
      type: object
      description: >-
        Router configuration with flattened settings. Only trigger may be a JSON
        object.
      properties:
        id:
          type: string
        name:
          type: string
        object_type:
          type: string
        has_integration:
          type: boolean
        is_published:
          type: boolean
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        archived:
          description: false when active, or ISO timestamp when archived
          oneOf:
            - type: boolean
            - type: string
              format: date-time
        archived_by:
          type: string
          description: Present when archived
        settings:
          type: object
          additionalProperties: true
          description: >-
            Flattened settings keyed by setting_id (overwrite, owner_field,
            distribution_model, etc.)
        users:
          type: array
          items:
            type: object
            properties:
              email:
                type: string
        teams:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
      example:
        id: 550e8400-e29b-41d4-a716-446655440000
        name: Contact Router
        object_type: contacts
        has_integration: true
        is_published: true
        archived: false
        created_at: '2026-05-01T10:00:00.000Z'
        updated_at: '2026-05-28T12:00:00.000Z'
        settings:
          overwrite: true
          owner_field: contact_owner
          distribution_model: round robin
          default_user: developer@test.com
          disable_default_assignment: false
          ignore_working_hours: true
          account_matching: true
          trigger:
            groups:
              - conditions: []
        users:
          - email: user@example.com
        teams:
          - name: Sales Team
    ApiError:
      type: object
      required:
        - message
        - error
      properties:
        message:
          type: string
        error:
          type: boolean
          enum:
            - true
        field:
          type: string
          description: Field that caused a conflict (409 duplicate responses)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Bearer JWT with valid account context.

````