Get Deal
Retrieve a single deal by ID using a query parameter.
GET
/v2/pipeline
Query Parameters
id uuid
Required
The deal ID to retrieve. Repeat the parameter to fetch multiple deals.
cURl example
curl -X GET 'https://lunarsend.com/api/v2/pipeline?id=7b1b0e42-1f2a-4e1e-8e5d-1f6a7b0c9d21' \
-H 'x-api-key: $LUNARSEND_API_KEY' \
-H 'Accept: application/json'Response
[
{
success: true,
id: "7b1b0e42-1f2a-4e1e-8e5d-1f6a7b0c9d21",
data: {
id: "7b1b0e42-1f2a-4e1e-8e5d-1f6a7b0c9d21",
user_id: "77f463d7-4107-1957-8b71-ab03acc319a2",
deal_size: 12000,
primary_contact: "150c081d-5d5f-401d-abd1-727c35222054",
stage: "Qualification",
open_date: "2025-10-04T14:25:11.000Z",
close_date: null,
owner: "John",
company: "A-B Logistics",
notes: "Kickoff pending legal review.",
contact_email: "ops@ABLogistics.com",
created_at: "2025-10-04T14:25:11.000Z",
},
},
]Response Fields
| Field | Type | Status | Format | Notes |
|---|---|---|---|---|
| status | enum successerror | required | - | - |
| id | string (uuid) - The ID from the request | required | uuid | Server-assigned UUID. |
| error | string - Error description (only present on error) | required | - | - |
| data | object | required | - | - |
| data.id | uuid | optional nullable | uuid | Server-assigned UUID. |
| data.user_id | uuid | optional nullable | uuid | Defaults to the caller's user_id. |
| data.deal_size | number | optional nullable | - | - |
| data.primary_contact | uuid | optional nullable | uuid | Server assigned linked contact based on contact_email field |
| data.stage | enum QualificationProposalNegotiationInterestedVerbalDiscoveryWonLost | required | - | - |
| data.open_date | ISO 8601 datetime | optional nullable | date-time | - |
| data.close_date | ISO 8601 datetime | optional nullable | date-time | - |
| data.owner | string | required | - | Display owner name (server-assigned). |
| data.company | string | required | - | - |
| data.notes | string | optional nullable | - | - |
| data.contact_email | string | optional nullable | - | |
| data.created_at | ISO 8601 datetime | optional nullable | date-time | Server-assigned. |