# GET /v1/company

**Service:** Company  
**Operation:** `CompanyService_GetCompany`

A singleton read keyed by the bearer token. Returns the company's identity, locale and currency settings, the measurement system its quantities and dimensions are expressed in, its tax context, contact and address details, and logo.

## Parameters

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `fields` | query | string | no | Comma-separated response fields to include, using camelCase JSON names (e.g. `orderId,total.amountMicros`). Dot paths reach into nested objects and map transparently across arrays. Paths are relative to the resource, not the response envelope; envelope keys like `nextPageToken` are always preserved. Only 2xx JSON responses are filtered; error bodies pass through unmodified. Unknown names are silently ignored. Takes precedence over `excludeFields` when both are provided. |
| `excludeFields` | query | string | no | Comma-separated response fields to exclude, using camelCase JSON names. Dot paths and array-transparency work the same as `fields`. Paths are relative to the resource, not the response envelope. Only 2xx JSON responses are filtered; error bodies pass through unmodified. Ignored when `fields` is also provided. |

## Responses

| Status | Schema | Description |
| --- | --- | --- |
| 200 | `GetCompanyResponse` | A successful response. |
| 401 | `Error` | The request is missing a valid bearer token, or the token is invalid or expired. |
| 403 | `Error` | The token is valid but does not permit this action, or the resource belongs to a company the token cannot act for. The error type is permission_denied. |
| 429 | `Error` | The request was throttled (rate_limited) or exceeded a size limit (resource_exhausted). When throttled, the Retry-After header says how many seconds to wait before retrying; a resource_exhausted request will fail the same way if retried unchanged. |
| default | `Error` | Any other error. The body is the same error envelope every error uses: a short stable type identifying the kind of failure (for example "rate_limited" or "internal"), a human-readable message, and the request's idempotency key echoed back when one was supplied. |

## Returns

`GetCompanyResponse`

| Field | Type | Description |
| --- | --- | --- |
| `company` | Company | Your company's settings. |
| `company.companyId` | string | The company's unique id. |
| `company.name` | string | The company's display name. |
| `company.domain` | string | The company's Factory domain. |
| `company.countryCode` | string | The company's country code, as an uppercase ISO 3166-1 alpha-2 code (e.g. "AU"). Empty when not set. |
| `company.timeZone` | string | The company's IANA time zone name (e.g. "Australia/Sydney"). |
| `company.currency` | string | The ISO 4217 currency code all monetary amounts use. Currently one of "AUD", "CAD", "NZD", "USD", "GBP", or "ZAR"; the set may grow. |
| `company.currencySymbol` | string | The currency's display symbol (e.g. "$"). |
| `company.measurementSystem` | MeasurementSystem | The measurement system quantities and dimensions are expressed in. The measurement system a company's quantities are expressed in.   - MEASUREMENT_SYSTEM_BOTH: The company works in both systems; each document line's pricing strategy declares its own unit. One of: MEASUREMENT_SYSTEM_UNSPECIFIED, MEASUREMENT_SYSTEM_METRIC, MEASUREMENT_SYSTEM_IMPERIAL, MEASUREMENT_SYSTEM_BOTH. |
| `company.taxRate` | string | The tax rate applied to the company's sales documents, as a decimal fraction (e.g. "0.10" means 10%). The server computes document tax with this rate; it cannot be set per document. |
| `company.taxIdentifier` | TaxIdentifier | The company's tax identifier, if set. On read the scheme is ABN for Australian accounts. |
| `company.taxIdentifier.value` | string | The identifier value, e.g. an 11-digit ABN. Its format depends on `type` and is NOT validated in v1: an ABN is accepted as any non-empty string of up to 15 characters. The length cap may widen when more schemes are supported. |
| `company.taxIdentifier.type` | TaxIdentifierType | Which tax / business registration scheme `value` belongs to. Must be a specified scheme when a TaxIdentifier is present. v1 accepts only ABN. The tax / business registration scheme a TaxIdentifier belongs to. v1 accepts only ABN; the remaining values are reserved for future non-AU support.   - TAX_IDENTIFIER_TYPE_UNSPECIFIED: Default, unset value. Not a valid scheme when a TaxIdentifier is supplied.  - TAX_IDENTIFIER_TYPE_ABN: Australian Business Number. The only scheme accepted in v1.  - TAX_IDENTIFIER_TYPE_EU_VAT: EU VAT number. Does not cover the United Kingdom — a UK VAT registration is TAX_IDENTIFIER_TYPE_GB_VAT. Reserved — not accepted in v1.  - TAX_IDENTIFIER_TYPE_US_EIN: US Employer Identification Number. Reserved — not accepted in v1.  - TAX_IDENTIFIER_TYPE_US_TIN: US Taxpayer Identification Number. Reserved — not accepted in v1.  - TAX_IDENTIFIER_TYPE_US_SSN: US Social Security Number (used by sole traders). Reserved — not accepted in v1.  - TAX_IDENTIFIER_TYPE_GB_VAT: United Kingdom VAT registration number. Reserved — not accepted in v1.  - TAX_IDENTIFIER_TYPE_NZ_GST: New Zealand GST number (the IRD number of a GST-registered business). Reserved — not accepted in v1. One of: TAX_IDENTIFIER_TYPE_UNSPECIFIED, TAX_IDENTIFIER_TYPE_ABN, TAX_IDENTIFIER_TYPE_EU_VAT, TAX_IDENTIFIER_TYPE_US_EIN, TAX_IDENTIFIER_TYPE_US_TIN, TAX_IDENTIFIER_TYPE_US_SSN, TAX_IDENTIFIER_TYPE_GB_VAT, TAX_IDENTIFIER_TYPE_NZ_GST. |
| `company.email` | string | The company's contact email address. |
| `company.phone` | string | The company's contact phone number. |
| `company.website` | string | The company's website URL. |
| `company.address` | string | The company's street address (first line). |
| `company.address2` | string | The company's street address (second line). |
| `company.city` | string | The company's city or suburb. |
| `company.state` | string | The company's state or region code (e.g. "VIC"). |
| `company.postalCode` | string | The company's postal code (ZIP code, postcode). |
| `company.logoUrl` | string | A URL to the company's logo image, if one is set. Served from Factory's media CDN; the URL is stable and safe to cache. |
| `company.pricingSettings` | PricingSettings | The account settings that affect how lines are priced. Always present on reads. |
| `company.pricingSettings.minimumLinealMetreLengthMm` | string | The minimum length charged on lines priced per lineal metre, in millimetres, as a decimal string (for example "1000"). Each measured piece shorter than this is priced as this length. Empty when not enabled. |
| `company.pricingSettings.minimumLinealFeetLengthMm` | string | The minimum length charged on lines priced per lineal foot, in millimetres, as a decimal string (for example "304.8", one foot). Each measured piece shorter than this is priced as this length. Empty when not enabled. |
| `company.pricingSettings.minimumFlashingLengthMm` | string | The minimum length charged on each piece of a flashing, in millimetres, as a decimal string. Factory prices a flashing piece shorter than this as this length; the API itself never prices flashings, so apply it when you compute a flashing line's `totalPrice`. Empty when not enabled. |
| `company.pricingSettings.crushFoldBendCount` | integer | The number of bends a crush fold counts as when a flashing's `bends` are counted. 0 means the default of 2. |

---

Source: https://developer.factory.app/reference/company/get-company · Factory Sales API v1