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

# Obtener Etapa

> Obtiene los detalles de una etapa específica

<Info>
  **Scope requerido:** `funnels:read`
</Info>

Obtén información detallada de una etapa del funnel por su ID, incluyendo el conteo de contactos.

***

## Path Parameters

<ParamField path="id" type="string" required>
  UUID de la etapa
</ParamField>

***

## Ejemplos

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.whaapy.com/funnel/v1/stages/550e8400-e29b-41d4-a716-446655440000" \
    -H "Authorization: Bearer wha_TU_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const stageId = '550e8400-e29b-41d4-a716-446655440000';
  const response = await fetch(
    `https://api.whaapy.com/funnel/v1/stages/${stageId}`,
    { headers: { 'Authorization': 'Bearer wha_TU_API_KEY' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  stage_id = '550e8400-e29b-41d4-a716-446655440000'
  response = requests.get(
      f'https://api.whaapy.com/funnel/v1/stages/{stage_id}',
      headers={'Authorization': 'Bearer wha_TU_API_KEY'}
  )
  ```

  ```php PHP theme={null}
  $stageId = '550e8400-e29b-41d4-a716-446655440000';
  $ch = curl_init("https://api.whaapy.com/funnel/v1/stages/{$stageId}");
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'Authorization: Bearer wha_TU_API_KEY'
  ]);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  $response = curl_exec($ch);
  ```
</RequestExample>

***

## Respuesta Exitosa

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "stage": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Qualified",
      "position": 1,
      "color": "#10b981",
      "contact_count": 45,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-28T10:00:00Z"
    }
  }
  ```
</ResponseExample>

***

## Errores

### 400 Bad Request

<ResponseExample>
  ```json 400 Bad Request theme={null}
  {
    "error": "validation_error",
    "message": "ID de etapa inválido"
  }
  ```
</ResponseExample>

### 404 Not Found

<ResponseExample>
  ```json 404 Not Found theme={null}
  {
    "error": "not_found",
    "message": "Etapa no encontrada"
  }
  ```
</ResponseExample>

***

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Actualizar Etapa" icon="pen" href="/api-reference/funnels/stages-update">
    Modificar nombre o color
  </Card>

  <Card title="Eliminar Etapa" icon="trash" href="/api-reference/funnels/stages-delete">
    Eliminar etapa del funnel
  </Card>
</CardGroup>