Skip to main content
GET
Retrieve a pipeline record

Authorizations

x-api-key
string
header
required

Copy the API key as provided by the Bridge Console.

Path Parameters

workspaceId
string<uuid>
required

Unique identifier of the workspace (UUID v4).

Example:

"b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234"

recordId
string
required

Unique identifier of the pipeline record.

Required string length: 1 - 255
Example:

"0d3c7f0e-5a43-5c0e-9f53-1f6a4b2e7d11"

Response

Successful Response

A record of a pipeline, such as a sales opportunity of a contact.

id
string
required

Unique identifier of the record.

Example:

"0d3c7f0e-5a43-5c0e-9f53-1f6a4b2e7d11"

pipelineId
string
required

Pipeline the record belongs to.

Example:

"5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10"

pipelineVersion
integer
required

Version of the pipeline the record follows.

Example:

3

stageId
string
required

Stage the record is in.

Example:

"stage-new"

state
enum<string>
required

OPEN while the record is in an open stage, FINAL once it is in a final stage.

Available options:
OPEN,
FINAL
Example:

"OPEN"

name
string
required

Name of the record.

Example:

"Acme renewal 2027"

contact
Contact · object
required

The contact the record belongs to.

source
enum<string>
required

How the record was created: API, ADVISOR, INBOUND_SESSION or FROM_PIPELINE.

Available options:
ADVISOR,
API,
INBOUND_SESSION,
FROM_PIPELINE
Example:

"API"

revision
integer
required

Goes up by one every time the record changes.

Example:

1

createdAt
string
required

When the record was created.

Example:

"2026-11-11T15:00:00.000Z"

updatedAt
string
required

When the record last changed.

Example:

"2026-11-11T15:00:00.000Z"

values
Values · object

Values of the record's attributes, keyed by attribute id.

Example:
ownerId
string | null

Id of the Bridge User who owns the record. Resolve it with GET /users/{userId}.

Example:

null

externalId
string | null

Your system's id for the record, when it was created with one.

Example:

"ERP-OPP-981"

closeReason
RecordCloseReasonResponse · object | null

The reason a closed record was closed with.

closedAt
string | null

When the record reached a final stage; null while it is open.

Example:

null