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

# Get partners and routing

> Find out whether other partners are on the number and what D-API's role is in Meta's Conversation Routing.

Shows whether other apps (partners) are connected to the same WhatsApp account
and which role D-API received in **Conversation Routing**. The `id` accepts the
connection id or the session id (`cloud-<uuid>`).

To understand the roles and when to use each, see
[Multiple partners on the same number](https://docs.d-api.cloud/en/api-oficial/multiplos-parceiros.md).

## Example

```bash theme={null}
curl https://api.d-api.cloud/api/v1/connections/cloud-api/<CONNECTION_ID>/routing \
  -H "Authorization: <YOUR_SECRET_API_KEY>"
```

```json theme={null}
{
  "success": true,
  "data": {
    "situation": "routed",
    "routingEnabled": true,
    "roles": ["escalation"],
    "isStandby": true,
    "isEscalation": true,
    "subscribedApps": [
      { "id": "1234567890", "name": "D-API", "isCurrentApp": true },
      { "id": "9876543210", "name": "Other CRM", "isCurrentApp": false }
    ],
    "otherAppsCount": 1
  }
}
```

| `situation` | Meaning |
| - | - |
| `exclusive` | Only D-API on the account. |
| `shared_without_routing` | Another partner and no routing: everyone receives everything and everyone replies. |
| `routed` | Routing is active. See `roles`, `isStandby` and `isEscalation`. |

> [!WARNING]
>
> Queries Meta live, and Meta rate-limits it. Call on demand, never before
> every send.


## OpenAPI

````yaml api-reference/openapi.en.json GET /api/v1/connections/cloud-api/{id}/routing
openapi: 3.1.0
info:
  title: D-API - Complete WhatsApp Infrastructure
  description: >-
    A scalable, robust solution for automation managers, SaaS products and end
    users who need a reliable WhatsApp integration. It offers multiple
    simultaneous instances, real-time webhooks, an intuitive dashboard and a
    documented REST API with 99.9% uptime and latency under 30ms.
  version: 1.2.1
  contact:
    name: Suporte D-API
    email: suporte@d-api.cloud
    url: https://d-api.cloud
servers:
  - url: https://api.d-api.cloud
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Home
    description: Base endpoints
  - name: Sessions
    description: Endpoints for managing sessions
  - name: Messages
    description: Endpoints for sending messages
  - name: Cloud API
    description: >-
      WhatsApp Official API (Meta Cloud API): manual connection, template
      management (list/create/delete) and template sending.
  - name: IVR Calls
    description: 'Voice call dispatch (IVR): single or bulk, with audio or an IVR flow.'
  - name: SMS
    description: 'SMS sending: single or bulk.'
  - name: Commands
    description: >-
      Look up asynchronous commands (async: true) by the commandId returned when
      enqueued.
paths:
  /api/v1/connections/cloud-api/{id}/routing:
    get:
      tags:
        - Cloud API
      summary: See other partners and D-API's role on the number
      description: >-
        Shows whether other apps (partners) are connected to the same WhatsApp
        account and which role D-API received in Meta's Conversation Routing.
        The `id` accepts the connection id or the session id (`cloud-<uuid>`).


        `data.situation`: `exclusive` (only D-API on the account),
        `shared_without_routing` (other apps and no routing: everyone receives
        everything and everyone can reply) or `routed` (routing active).


        `data.roles`: entry points D-API owns (`customer_service`, `ctwa`,
        `marketing`, `utility`, `calls`) and `escalation` if D-API can take over
        any conversation. `data.isStandby`: D-API receives a copy of other apps'
        conversations. `data.isEscalation`: shortcut for `roles` containing
        `escalation`. `data.subscribedApps`: apps subscribed to the account
        (`isCurrentApp` marks D-API). `data.otherAppsCount`: how many belong to
        other partners.


        Queries Meta live and Meta rate-limits it: call on demand (settings
        screen, after a 131070 error), never before every send.
      operationId: getApiV1ConnectionsCloud-apiByIdRouting
      parameters:
        - schema:
            minLength: 1
            type: string
          in: path
          name: id
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data: {}
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - success
            multipart/form-data:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data: {}
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - success
            text/plain:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data: {}
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - success
          description: Successful response
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'API Key for authentication. Format: <API_KEY>'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.