GET
/
quickbooks-desktop
/
company
JavaScript
import Conductor from 'conductor-node';

const conductor = new Conductor({
  apiKey: process.env['CONDUCTOR_SECRET_KEY'], // This is the default and can be omitted
});

const company = await conductor.qbd.company.retrieve({ conductorEndUserId: 'end_usr_1234567abcdefg' });

console.log(company.accountantCopy);
{
  "isSampleCompanyFile": false,
  "companyName": "John Doe's Plumbing",
  "legalCompanyName": "John Doe's Plumbing, LLC",
  "address": {
    "line1": "Conductor Labs Inc.",
    "line2": "540 Market St.",
    "line3": "Suite 100",
    "line4": "",
    "line5": "",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94110",
    "country": "United States",
    "note": "Conductor HQ"
  },
  "legalAddress": {
    "line1": "Conductor Labs Inc.",
    "line2": "540 Market St.",
    "line3": "Suite 100",
    "line4": "",
    "line5": "",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94110",
    "country": "United States",
    "note": "Conductor HQ"
  },
  "addressForCustomer": {
    "line1": "Conductor Labs Inc.",
    "line2": "540 Market St.",
    "line3": "Suite 100",
    "line4": "",
    "line5": "",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94110",
    "country": "United States",
    "note": "Conductor HQ"
  },
  "phone": "+1-555-123-4567",
  "fax": "+1-555-555-1212",
  "email": "company@example.com",
  "website": "https://www.johndoeplumbing.com",
  "fiscalYearStartMonth": "january",
  "incomeTaxYearStartMonth": "january",
  "companyType": "WholesaleDistributionandSales",
  "ein": "123456789",
  "ssn": "123-45-6789",
  "taxForm": "form_1040",
  "subscribedServices": {
    "services": [
      {
        "name": "Intuit Payroll",
        "domain": "payroll.qb",
        "serviceStatus": "active"
      }
    ]
  },
  "accountantCopy": {
    "accountantCopyExists": true,
    "dividingDate": "2024-01-01"
  },
  "customFields": [
    {
      "ownerId": "0",
      "name": "Customer Rating",
      "type": "string_1024_type",
      "value": "Premium"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Your Conductor secret key using Bearer auth (e.g., "Authorization: Bearer {{YOUR_SECRET_KEY}}").

Headers

​
Conductor-End-User-Id
string
required

The ID of the EndUser to receive this request (e.g., "Conductor-End-User-Id: {{END_USER_ID}}").

Example:

"end_usr_1234567abcdefg"

Response

200 - application/json

Returns an object with the company file's information.

The response is of type object.