Retrieve a business

Retrieves the details of an existing business. Supply the unique business ID from either a business creation request or the business list, and Treevox will return the corresponding business information.

List all contacts

GET https://api.treevox.com/v1/business/:id

Retrieves the details of an existing business. Supply the unique business ID from either a business creation request or the product list, and Treevox will return the corresponding product information.

Path Parameters

Name	Type	Description
id*	Number	The Id of the business to be retrieved

Query Parameters

Name	Type	Description
expand[]	String	values: organization, country, stage, assignedTo, userCreator. Doc expandable

Headers

Name	Type	Description
Content-Type*	application/json
Accept-Encoding	gzip
x-api-key*	String	your api key in treevox

200: OK Returns a business object if a valid identifier was provided.

{
    "id": 1,
    "title": "New Website Project",
    "value": 15000,
    "deadline": "2025-12-31T23:59:59.000Z",
    "private": false,
    "position": 1,
    "dateWon": "2025-03-20T15:30:00.000Z",
    "reasonLost": null,
    "statusId": 2,
    "organizationId": 45,
    "currencyId": 1,
    "userOwnerId": 12,
    "userCreatorId": 8,
    "boardId": 3,
    "stageId": 7,
    "createdAt": "2025-01-10T10:15:30.000Z",
    "updatedAt": "2025-09-10T12:45:00.000Z"
}

404: Not Found Returns error.

{
    "timestamp": "2021-11-25T03:45:20.986Z",
    "message": "Contact not found",
    "code": "contact_not_found"
}