Skip to main content
GET
Return a pipeline by ID

Supported products

Authorizations

Authorization
string
header
required

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

Scopes

crm.objects.owners.read
crm.objects.deals.read
crm.objects.subscriptions.read
crm.objects.services.read
crm.objects.tickets.sensitive.read
crm.objects.listings.write
crm.objects.custom.read
crm.objects.tasks.read
crm.objects.custom.sensitive.write.v2
crm.objects.custom.highly_sensitive.write.v2
crm.schemas.quotes.read
crm.objects.companies.read
crm.objects.tickets.highly_sensitive.read
crm.objects.companies.sensitive.read.v2
media_bridge.read
crm.objects.deals.highly_sensitive.read.v2
crm.objects.companies.highly_sensitive.read.v2
crm.objects.contacts.sensitive.write.v2
crm.objects.calls.read
crm.objects.meetings.read
crm.schemas.services.read
crm.schemas.line_items.read
crm.schemas.subscriptions.read
crm.objects.projects.highly_sensitive.write
crm.schemas.companies.read
crm.objects.products.write
crm.objects.feedback_submissions.read
crm.objects.services.write
crm.objects.subscriptions.write
crm.schemas.calls.read
crm.schemas.meetings.read
crm.objects.contacts.read
crm.objects.invoices.read
crm.schemas.orders.read
crm.schemas.emails.read
crm.schemas.deals.read
crm.objects.deals.write
e-commerce
crm.schemas.notes.read
crm.objects.projects.read
crm.objects.companies.sensitive.write.v2
crm.objects.custom.highly_sensitive.read.v2
crm.objects.goals.write
crm.objects.line_items.write
crm.objects.contacts.write
crm.objects.goals.read
crm.objects.line_items.read
crm.objects.projects.sensitive.write
crm.objects.deals.sensitive.read.v2
crm.objects.quotes.write
crm.schemas.contacts.read
tickets.highly_sensitive.v2
crm.objects.leads.read
crm.objects.leads.write
crm.schemas.tasks.read
crm.objects.emails.read
crm.schemas.invoices.read
crm.objects.quotes.read
crm.objects.notes.read
crm.objects.courses.read
crm.objects.marketing_events.read
crm.pipelines.orders.read
crm.objects.contacts.sensitive.read.v2
crm.schemas.projects.read
crm.objects.orders.read
automation
crm.objects.companies.write
crm.schemas.carts.read
cpq.quotes.write
crm.schemas.listings.read
crm.objects.appointments.sensitive.read.v2
crm.objects.contacts.highly_sensitive.read.v2
crm.objects.contacts.highly_sensitive.write.v2
crm.objects.commercepayments.write
crm.objects.invoices.write
crm.objects.custom.sensitive.read.v2
crm.objects.users.read
crm.objects.appointments.write
crm.objects.deals.sensitive.write.v2
cpq.quotes.read
crm.objects.appointments.sensitive.write.v2
crm.objects.projects.highly_sensitive.read
crm.schemas.appointments.read
crm.objects.custom.write
tickets.sensitive.v2
crm.objects.appointments.read
crm.schemas.courses.read
crm.objects.companies.highly_sensitive.write.v2
crm.objects.deals.highly_sensitive.write.v2
crm.objects.projects.sensitive.read
crm.pipelines.approval.read
crm.objects.projects.write
crm.objects.marketing_events.write
crm.schemas.custom.read
crm.objects.carts.read
crm.objects.courses.write
crm.schemas.commercepayments.read
crm.objects.listings.read

Path Parameters

objectType
string
required
pipelineId
string
required

Response

successful operation

archived
boolean
required

Whether the pipeline is archived.

createdAt
string<date-time>
required

The date the pipeline was created. The default pipelines will have createdAt = 0.

displayOrder
integer<int32>
required

The order for displaying this pipeline. If two pipelines have a matching displayOrder, they will be sorted alphabetically by label.

id
string
required

A unique identifier generated by HubSpot that can be used to retrieve and update the pipeline.

label
string
required

A unique label used to organize pipelines in HubSpot's UI

stages
object[]
required

The stages associated with the pipeline. They can be retrieved and updated via the pipeline stages endpoints.

updatedAt
string<date-time>
required

The date the pipeline was last updated.

archivedAt
string<date-time>

The date the pipeline was archived. archivedAt will only be present if the pipeline is archived.

Last modified on September 9, 2026