Opportunity
List opportunities
- Introduction
- API Reference
- GETList call outcomes
- GETList company categories
- GETList contract types
- GETList custom fields
- GETList industries
- GETList lead sources
- GETList loss reasons
- GETList market sectors
- POSTCreate opportunity
- PATCHUpdate opportunity
- GETList opportunities
- GETGet opportunity
- DELDelete opportunity
- GETList opp stages
Call Outcome
Company Category
Contract Type
Custom Field
Industry
Lead Source
Loss Reason
Market Sector
Opportunity
Opp Stage
Opportunity
List opportunities
GET
/
api
/
2023-01
/
opportunities
Authorization
string
*
Bearer
Authorization
Required
string
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Authorization
string
*
Authorization
Required
string
filters
object
filters
object
id
integer
id
integer
name
string
name
string
curl --request GET \
--url https://api.buildr.com/api/2023-01/opportunities \
--header 'Authorization: <authorization>'
{
"opportunities": [
{
"id": "787",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Culver High Rise",
"stage_age": 20,
"probability": 0.5,
"description": "A project to build a high rise in Culver City",
"project_duration": 12,
"pursuit_duration": 90,
"project_number": "23-1329",
"project_status": "active",
"square_feet": 100000,
"price_per_square_foot": 100,
"units": 80,
"price_per_unit": 125000,
"external_id": "external-id-123",
"amount": 10000000,
"award_date": "2023-06-15",
"bid_due_date": "2023-05-22",
"start_date": "2023-09-04",
"end_date": "2024-06-30",
"address": {
"street_address": "123 Main St",
"street_address2": "Apt 1",
"city": "Los Angeles",
"state": "CA",
"zip": "90001",
"country": "US"
},
"assigned_to": {
"id": "953",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"first_name": "Russell",
"last_name": "Westbrook",
"name": "Russell Westbrook",
"email": "russell.westbrook@example.com"
},
"company": {
"id": "101",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "<string>",
"website": "<string>"
},
"contact": {
"id": "418",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"first_name": "Austin",
"last_name": "Reaves",
"name": "Austin Reaves",
"email": "austin.reaves@example.com"
},
"contract_type": {
"id": "721",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Design/Build"
},
"created_by": {
"id": "953",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"first_name": "Russell",
"last_name": "Westbrook",
"name": "Russell Westbrook",
"email": "russell.westbrook@example.com"
},
"division": {
"id": "689",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "<string>"
},
"import": {
"id": "456",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "<string>"
},
"lead_source": {
"id": "346",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Website"
},
"loss_reason": {
"id": "254",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Project Canceled"
},
"market_sector": {
"id": "902",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Education"
},
"opp_stage": {
"id": "693",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "<string>",
"category": "open"
},
"custom_fields": {}
}
]
}
Headers
Authorization
string
requiredQuery Parameters
filters
object
filters.id
integer
filters.name
string
Response
200 - application/json
opportunities
object[]
requiredopportunities.id
string
requiredopportunities.created_at
string
requiredopportunities.updated_at
string
requiredopportunities.name
string
requiredopportunities.stage_age
integer
requiredopportunities.probability
number
requiredopportunities.description
string
requiredopportunities.project_duration
integer
requiredopportunities.pursuit_duration
integer
requiredopportunities.project_number
string
requiredopportunities.project_status
enum<string>
requiredAvailable options:
pursuit
, upcoming
, active
, complete
, lost
opportunities.square_feet
integer | null
requiredopportunities.price_per_square_foot
number | null
requiredopportunities.units
integer | null
requiredopportunities.price_per_unit
number | null
requiredopportunities.external_id
string | null
requiredopportunities.amount
number
requiredopportunities.award_date
string | null
requiredopportunities.bid_due_date
string | null
requiredopportunities.start_date
string | null
requiredopportunities.end_date
string | null
requiredopportunities.address
object
requiredopportunities.address.street_address
string
requiredopportunities.address.street_address2
string
requiredopportunities.address.city
string
requiredopportunities.address.state
string
opportunities.address.zip
string
requiredopportunities.address.country
enum<string>
requiredAvailable options:
AU
, CA
, GB
, IS
, NZ
, UK
, US
opportunities.assigned_to
object | null
requiredopportunities.assigned_to.id
string
requiredopportunities.assigned_to.created_at
string
requiredopportunities.assigned_to.updated_at
string
requiredopportunities.assigned_to.first_name
string
requiredopportunities.assigned_to.last_name
string
requiredopportunities.assigned_to.name
string
requiredopportunities.assigned_to.email
string
requiredopportunities.company
object
requiredopportunities.company.id
string
requiredopportunities.company.created_at
string
requiredopportunities.company.updated_at
string
requiredopportunities.company.name
string
requiredopportunities.company.website
string
requiredopportunities.contact
object | null
requiredopportunities.contact.id
string
requiredopportunities.contact.created_at
string
requiredopportunities.contact.updated_at
string
requiredopportunities.contact.first_name
string
requiredopportunities.contact.last_name
string
requiredopportunities.contact.name
string
requiredopportunities.contact.email
string
requiredopportunities.contract_type
object | null
requiredopportunities.contract_type.id
string
requiredopportunities.contract_type.created_at
string
requiredopportunities.contract_type.updated_at
string
requiredopportunities.contract_type.name
string
requiredopportunities.created_by
object
requiredopportunities.created_by.id
string
requiredopportunities.created_by.created_at
string
requiredopportunities.created_by.updated_at
string
requiredopportunities.created_by.first_name
string
requiredopportunities.created_by.last_name
string
requiredopportunities.created_by.name
string
requiredopportunities.created_by.email
string
requiredopportunities.division
object | null
requiredopportunities.division.id
string
requiredopportunities.division.created_at
string
requiredopportunities.division.updated_at
string
requiredopportunities.division.name
string
requiredopportunities.import
object | null
requiredopportunities.import.id
string
requiredopportunities.import.created_at
string
requiredopportunities.import.updated_at
string
requiredopportunities.import.name
string
requiredopportunities.lead_source
object | null
requiredopportunities.lead_source.id
string
requiredopportunities.lead_source.created_at
string
requiredopportunities.lead_source.updated_at
string
requiredopportunities.lead_source.name
string
requiredopportunities.loss_reason
object | null
requiredopportunities.loss_reason.id
string
requiredopportunities.loss_reason.created_at
string
requiredopportunities.loss_reason.updated_at
string
requiredopportunities.loss_reason.name
string
requiredopportunities.market_sector
object | null
requiredopportunities.market_sector.id
string
requiredopportunities.market_sector.created_at
string
requiredopportunities.market_sector.updated_at
string
requiredopportunities.market_sector.name
string
requiredopportunities.opp_stage
object
requiredopportunities.opp_stage.id
string
requiredopportunities.opp_stage.created_at
string
requiredopportunities.opp_stage.updated_at
string
requiredopportunities.opp_stage.name
string
requiredopportunities.opp_stage.category
enum<string>
requiredAvailable options:
open
, won
, lost
opportunities.custom_fields
object
curl --request GET \
--url https://api.buildr.com/api/2023-01/opportunities \
--header 'Authorization: <authorization>'
{
"opportunities": [
{
"id": "787",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Culver High Rise",
"stage_age": 20,
"probability": 0.5,
"description": "A project to build a high rise in Culver City",
"project_duration": 12,
"pursuit_duration": 90,
"project_number": "23-1329",
"project_status": "active",
"square_feet": 100000,
"price_per_square_foot": 100,
"units": 80,
"price_per_unit": 125000,
"external_id": "external-id-123",
"amount": 10000000,
"award_date": "2023-06-15",
"bid_due_date": "2023-05-22",
"start_date": "2023-09-04",
"end_date": "2024-06-30",
"address": {
"street_address": "123 Main St",
"street_address2": "Apt 1",
"city": "Los Angeles",
"state": "CA",
"zip": "90001",
"country": "US"
},
"assigned_to": {
"id": "953",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"first_name": "Russell",
"last_name": "Westbrook",
"name": "Russell Westbrook",
"email": "russell.westbrook@example.com"
},
"company": {
"id": "101",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "<string>",
"website": "<string>"
},
"contact": {
"id": "418",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"first_name": "Austin",
"last_name": "Reaves",
"name": "Austin Reaves",
"email": "austin.reaves@example.com"
},
"contract_type": {
"id": "721",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Design/Build"
},
"created_by": {
"id": "953",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"first_name": "Russell",
"last_name": "Westbrook",
"name": "Russell Westbrook",
"email": "russell.westbrook@example.com"
},
"division": {
"id": "689",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "<string>"
},
"import": {
"id": "456",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "<string>"
},
"lead_source": {
"id": "346",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Website"
},
"loss_reason": {
"id": "254",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Project Canceled"
},
"market_sector": {
"id": "902",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Education"
},
"opp_stage": {
"id": "693",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "<string>",
"category": "open"
},
"custom_fields": {}
}
]
}