Zum Hauptinhalt springen
GET
/
crm
/
v3
/
pipelines
/
{objectType}
/
{pipelineId}
/
stages
/
{stageId}
Eine Pipeline-Phase anhand der ID zurückgeben
curl --request GET \
  --url https://api.hubapi.com/crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId} \
  --header 'Authorization: Bearer <token>'
{
  "archived": false,
  "createdAt": "2019-10-30T03:30:17.883Z",
  "displayOrder": 0,
  "id": "1234912",
  "label": "In Progress",
  "metadata": {
    "ticketState": "OPEN"
  },
  "updatedAt": "2019-12-07T16:50:06.678Z"
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos

Autorisierungen

Authorization
string
header
erforderlich

The access token received from the authorization server in the OAuth 2.0 flow.

Pfadparameter

objectType
string
erforderlich

Der Objekttyp der Phase, die abgerufen wird (z. B. Deals oder Tickets)

pipelineId
string
erforderlich

Die eindeutige ID der Pipeline, die die abzurufende Phase enthält.

stageId
string
erforderlich

Die eindeutige ID der Phase, die aus der Pipeline abgerufen werden soll.

Antwort

successful operation

A pipeline stage definition.

archived
boolean
erforderlich

Ob die Pipeline archiviert ist.

createdAt
string<date-time>
erforderlich

Das Datum, an dem die Pipeline-Phase erstellt wurde. Für die Phasen von Standard-Pipelines gilt createdAt = 0.

displayOrder
integer<int32>
erforderlich

Die Reihenfolge, in der diese Pipeline-Phase angezeigt wird. Wenn „displayOrder“ bei zwei Pipeline-Phasen übereinstimmt, werden sie alphabetisch nach Label sortiert.

id
string
erforderlich

Eine von HubSpot generierte eindeutige ID, die zum Abrufen und Aktualisieren der Pipeline-Phase verwendet werden kann

label
string
erforderlich

Ein Label zum Organisieren von Pipeline-Phasen in der HubSpot-Benutzeroberfläche. Das Label jeder Pipeline-Phase muss innerhalb dieser Pipeline eindeutig sein.

metadata
object
erforderlich

Ein JSON-Objekt mit Eigenschaften, die nicht in allen Objekt-Pipelines vorhanden sind.

Bei Deal-Pipelines ist das Feld „probability“ ein Pflichtfeld ({ "probability": 0.5 }). Es zeigt die Wahrscheinlichkeit an, mit der ein Deal abgeschlossen wird. Mögliche Werte liegen zwischen 0,0 und 1,0 in Schritten von 0,1.

Bei Ticket-Pipelines ist das Feld „ticketState“ optional ({ "ticketState": "OPEN" }). Es zeigt an, ob das Ticket noch offen ist oder von einem Mitglied Ihres Support-Teams geschlossen wurde. Mögliche Werte sind OFFEN oder GESCHLOSSEN.

updatedAt
string<date-time>
erforderlich

Das Datum, an dem die Pipeline-Phase zuletzt aktualisiert wurde

archivedAt
string<date-time>

Das Datum, an dem die Pipeline archiviert ist. „archivedAt“ ist nur vorhanden, wenn die Pipeline archiviert ist.

writePermissions
enum<string>

Definiert die Ebene des Schreibzugriffs für die Pipeline-Phase. Mögliche Werte sind „CRM_PERMISSIONS_ENFORCEMENT“, „READ_ONLY“ oder „INTERNAL_ONLY“.

Verfügbare Optionen:
CRM_PERMISSIONS_ENFORCEMENT,
INTERNAL_ONLY,
READ_ONLY
Last modified on March 24, 2026