---
title: "Get Deals By Stage"
method: GET
path: "/api/hubspot/deals"
tags: ["hubspot", "hubspot"]
---

# Get Deals By Stage

`GET /api/hubspot/deals`

Devuelve negocios filtrados por dealstage. Soporta paginación con `after`.

Con `include_contacts=true` enriquece cada deal con datos del contacto asociado.

## Query parameters

- `dealstage` string, required
- `limit` integer
- `after` string, nullable
- `include_contacts` boolean

## Response `200`

Successful Response

- DealsByStageResponse
  - `deals` DealByStageItem[], required
    - `deal_id` string, required
    - `deal_name` string, nullable
    - `dealstage` string, nullable
    - `created_at` string, nullable
    - `owner_id` string, nullable
    - `contact_id` string, nullable
    - `contact_name` string, nullable
    - `contact_email` string, nullable
    - `contact_address` string, nullable
    - `contact_zip` string, nullable
    - `contact_city` string, nullable
    - `contact_province` string, nullable
    - `contact_phone` string, nullable
  - `total` integer, required
  - `next_after` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api.md) · [All operations](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hogarsolar/hogarsolar-backend-api/revisions/d9861e46bef8/schema)