Deals

GET

https://api.data.v4.marketing/v1/hubspot/deals

Returns HubSpot CRM deals with amount, stage, pipeline, dates, and associations.

Filters:

workspaceId (required)

integrationId, organizationId, integrationName (optional)

id – deal ID

dealStage – deal stage (e.g. closedwon, closedlost)

pipeline – pipeline name

dealName – deal name

createdStart, createdEnd – creation date range

lastModifiedStart, lastModifiedEnd – last update date range

page, limit – pagination

Requisição

Authorization

API Key

Adicionar parâmetro em header

x-client-id

Exemplo:

x-client-id: ********************

API Key

Adicionar parâmetro em header

x-client-secret

Exemplo:

x-client-secret: ********************

Parâmetros de Consulta

Respostas

🟢200

application/json

Successful response

Body

🟠400

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.data.v4.marketing/v1/hubspot/deals?workspaceId=workspace_123&integrationId&organizationId&integrationName&id&dealStage&pipeline&dealName&createdStart=2026-01-01T00:00:00Z&createdEnd=2026-01-31T23:59:59Z&lastModifiedStart=2026-01-01T00:00:00Z&lastModifiedEnd=2026-01-31T23:59:59Z&page&limit' \
--header 'x-client-id: <api-key>' \
--header 'x-client-secret: <api-key>'

Response Example

200 - Exemplo 1

{
    "data": [
        {
            "id": "string",
            "created_at": "2019-08-24T14:15:22.123Z",
            "updated_at": "2019-08-24T14:15:22.123Z",
            "archived": true,
            "amount": 0,
            "amount_in_home_currency": 0,
            "close_date": "2019-08-24T14:15:22.123Z",
            "create_date": "2019-08-24T14:15:22.123Z",
            "days_to_close": "string",
            "deal_currency_code": "string",
            "deal_name": "string",
            "deal_stage": "string",
            "hs_campaign": "string",
            "hs_closed_amount": 0,
            "hs_closed_amount_in_home_currency": 0,
            "hs_closed_won_date": "2019-08-24T14:15:22.123Z",
            "hs_created_by_user_id": "string",
            "hs_exchange_rate": 0,
            "hs_forecast_amount": 0,
            "hs_forecast_probability": "string",
            "hs_is_closed": "string",
            "hs_is_closed_lost": "string",
            "hs_is_closed_won": "string",
            "hs_lastmodifieddate": "2019-08-24T14:15:22.123Z",
            "hs_primary_associated_company": "string",
            "hs_updated_by_user_id": "string",
            "hubspot_owner_id": "string",
            "pipeline": "string",
            "assoc_line_item_ids": [
                "string"
            ],
            "assoc_company_ids": [
                "string"
            ],
            "assoc_contact_ids": [
                "string"
            ],
            "integration_id": "string",
            "workspace_id": "string",
            "organization_id": "string",
            "user_id": "string",
            "document_id": "string",
            "inserted_at": "2019-08-24T14:15:22.123Z",
            "integration_name": "string"
        }
    ],
    "meta": {
        "page": 0,
        "limit": 0,
        "hasNextPage": true,
        "hasPreviousPage": true
    }
}

Modificado em 2026-02-10 19:47:40