# Models

## The CompanyInformation object

```json
{"openapi":"3.1.0","info":{"title":"Agency API — Company Information","version":"2.0"},"components":{"schemas":{"CompanyInformation":{"type":"object","description":"Your agency's company profile.","properties":{"CompanyName":{"type":"string","description":"The agency's registered business name as it appears on impact.com."},"Website":{"type":"string","description":"The agency's primary website URL."},"PrimaryPhoneNumber":{"type":"string","description":"The agency's primary contact phone number. Digits only — no spaces, dashes, or other formatting characters."},"PrimaryPhoneNumberCountry":{"type":"string","description":"The country associated with the primary phone number (e.g., `US`, `SOUTHAFRICA`). Uses impact.com country codes, which may differ from ISO 3166."},"SecondaryPhoneNumber":{"type":"string","description":"An optional secondary contact phone number. Digits only. Empty if not set."},"SecondaryPhoneNumberCountry":{"type":"string","description":"The country associated with the secondary phone number. Empty if `SecondaryPhoneNumber` is not set."},"MinimumContactRating":{"type":"string","description":"The minimum impact.com contact rating required for partner outreach to your agency, returned as a numeric string from `\"1\"` (lowest) to `\"5\"` (highest). Used to filter inbound partner contact requests by quality."},"Timezone":{"type":"string","description":"The agency's default timezone, in impact.com's display format (e.g., `\"(GMT -06:00) Central Time (US & Canada)\"`).\n\n> **Note:** This field uses a custom display string, not an IANA timezone identifier. The leading `(GMT ±HH:MM)` offset reflects standard time and does not automatically adjust for daylight saving."},"Currency":{"type":"string","description":"The agency's default billing currency in ISO 4217 format."},"RegisteredForIndirectTax":{"type":"string","description":"Indicates whether the agency is registered for indirect taxes (e.g., VAT, GST). Returns `\"true\"` or `\"false\"` as a string value.","enum":["true","false"]},"IndirectTaxNumber":{"type":"string","description":"The agency's indirect tax registration number (e.g., a VAT, GST, or HST number). Empty if `RegisteredForIndirectTax` is `\"false\"`."},"OrganizationType":{"type":"string","description":"The agency's legal organization type.\n\n| Value | Description |\n|---|---|\n| `CORP` | Corporation or limited company. |\n| `NONP_GOV` | Non-profit organization or government entity. |\n| `OTHER` | Any other organization type. |","enum":["CORP","NONP_GOV","OTHER"]},"EinSsnForeignTaxId":{"type":"string","description":"The agency's master tax identification number. Accepts a US EIN (Employer Identification Number), US SSN (Social Security Number), or a foreign tax equivalent depending on the agency's jurisdiction.\n\nFor security, only the last four digits are returned and the rest are masked (e.g., `XXXXX4832`). Returns an empty string if no tax ID has been provided."},"CorporateAddress":{"allOf":[{"$ref":"#/components/schemas/Address"}],"description":"The agency's registered corporate (legal) address."},"BillingAddress":{"allOf":[{"$ref":"#/components/schemas/Address"}],"description":"The address used for billing and invoicing. May be the same as the corporate address."},"FinancialContact":{"allOf":[{"$ref":"#/components/schemas/Contact"}],"description":"The agency employee responsible for finance, billing, and payment matters."},"TechnicalContact":{"allOf":[{"$ref":"#/components/schemas/Contact"}],"description":"The agency employee responsible for integration, API access, and technical issues."},"SecurityContact":{"allOf":[{"$ref":"#/components/schemas/Contact"}],"description":"The agency employee responsible for security incidents, audits, and compliance."},"CommercialContact":{"allOf":[{"$ref":"#/components/schemas/Contact"}],"description":"The agency employee responsible for commercial, partnership, and account matters."},"Uri":{"type":"string","description":"The relative URI for this resource within the Agency API."}}},"Address":{"type":"object","description":"A physical address on the agency's account.","properties":{"AddressLine1":{"type":"string","description":"First line of the street address."},"AddressLine2":{"type":"string","description":"Second line of the address (suite, floor, unit, etc.). May be an empty string if not provided."},"City":{"type":"string","description":"City or municipality."},"State":{"type":"string","description":"State, province, or region. May be empty for countries that do not subdivide this way."},"PostalCode":{"type":"string","description":"ZIP or postal code."},"Country":{"type":"string","description":"Country code, using impact.com's format (e.g., `US`, `SOUTHAFRICA`). May differ from ISO 3166."}}},"Contact":{"type":"object","description":"An agency employee assigned to a key contact role.","properties":{"UserId":{"type":"string","description":"The impact.com numeric user ID of the assigned employee. Empty if no contact has been assigned to this role.\n\nTo resolve to a full user record, use the Users endpoint."},"Name":{"type":"string","description":"The contact's full display name. Empty if no contact is assigned."},"Email":{"type":"string","format":"email","description":"The contact's email address. Empty if no contact is assigned."},"WorkPhoneNumber":{"type":"string","description":"The contact's work phone number. Digits only. Empty if not set."},"WorkPhoneNumberCountry":{"type":"string","description":"The country associated with the work phone number."},"CellPhoneNumber":{"type":"string","description":"The contact's mobile phone number. Digits only. Empty if not set."},"CellPhoneNumberCountry":{"type":"string","description":"The country associated with the cell phone number."}}}}}}
```

## The CompanyInformationUpdate object

```json
{"openapi":"3.1.0","info":{"title":"Agency API — Company Information","version":"2.0"},"components":{"schemas":{"CompanyInformationUpdate":{"type":"object","description":"Partial company information update. All fields are optional — omitted fields keep their existing values.\n\nNested objects (addresses, contacts) may also be updated partially; you do not need to provide every sub-field.","properties":{"CompanyName":{"type":"string","description":"The agency's registered business name."},"Website":{"type":"string","description":"The agency's primary website URL."},"PrimaryPhoneNumber":{"type":"string","description":"The agency's primary contact phone number. Digits only."},"PrimaryPhoneNumberCountry":{"type":"string","description":"The country associated with the primary phone number."},"SecondaryPhoneNumber":{"type":"string","description":"An optional secondary contact phone number. Digits only."},"SecondaryPhoneNumberCountry":{"type":"string","description":"The country associated with the secondary phone number."},"MinimumContactRating":{"type":"string","description":"Minimum contact rating as a numeric string (`\"1\"`–`\"5\"`)."},"Timezone":{"type":"string","description":"The agency's default timezone in impact.com's display format."},"Currency":{"type":"string","description":"The agency's default billing currency (ISO 4217)."},"RegisteredForIndirectTax":{"type":"string","enum":["true","false"],"description":"Whether the agency is registered for indirect taxes. Boolean as string."},"IndirectTaxNumber":{"type":"string","description":"The agency's indirect tax registration number."},"OrganizationType":{"type":"string","enum":["CORP","NONP_GOV","OTHER"],"description":"The agency's legal organization type."},"EinSsnForeignTaxId":{"type":"string","description":"The agency's master tax identification number (EIN, SSN, or foreign equivalent)."},"CorporateAddress":{"$ref":"#/components/schemas/Address"},"BillingAddress":{"$ref":"#/components/schemas/Address"},"FinancialContact":{"$ref":"#/components/schemas/Contact"},"TechnicalContact":{"$ref":"#/components/schemas/Contact"},"SecurityContact":{"$ref":"#/components/schemas/Contact"},"CommercialContact":{"$ref":"#/components/schemas/Contact"}}},"Address":{"type":"object","description":"A physical address on the agency's account.","properties":{"AddressLine1":{"type":"string","description":"First line of the street address."},"AddressLine2":{"type":"string","description":"Second line of the address (suite, floor, unit, etc.). May be an empty string if not provided."},"City":{"type":"string","description":"City or municipality."},"State":{"type":"string","description":"State, province, or region. May be empty for countries that do not subdivide this way."},"PostalCode":{"type":"string","description":"ZIP or postal code."},"Country":{"type":"string","description":"Country code, using impact.com's format (e.g., `US`, `SOUTHAFRICA`). May differ from ISO 3166."}}},"Contact":{"type":"object","description":"An agency employee assigned to a key contact role.","properties":{"UserId":{"type":"string","description":"The impact.com numeric user ID of the assigned employee. Empty if no contact has been assigned to this role.\n\nTo resolve to a full user record, use the Users endpoint."},"Name":{"type":"string","description":"The contact's full display name. Empty if no contact is assigned."},"Email":{"type":"string","format":"email","description":"The contact's email address. Empty if no contact is assigned."},"WorkPhoneNumber":{"type":"string","description":"The contact's work phone number. Digits only. Empty if not set."},"WorkPhoneNumberCountry":{"type":"string","description":"The country associated with the work phone number."},"CellPhoneNumber":{"type":"string","description":"The contact's mobile phone number. Digits only. Empty if not set."},"CellPhoneNumberCountry":{"type":"string","description":"The country associated with the cell phone number."}}}}}}
```

## The Address object

```json
{"openapi":"3.1.0","info":{"title":"Agency API — Company Information","version":"2.0"},"components":{"schemas":{"Address":{"type":"object","description":"A physical address on the agency's account.","properties":{"AddressLine1":{"type":"string","description":"First line of the street address."},"AddressLine2":{"type":"string","description":"Second line of the address (suite, floor, unit, etc.). May be an empty string if not provided."},"City":{"type":"string","description":"City or municipality."},"State":{"type":"string","description":"State, province, or region. May be empty for countries that do not subdivide this way."},"PostalCode":{"type":"string","description":"ZIP or postal code."},"Country":{"type":"string","description":"Country code, using impact.com's format (e.g., `US`, `SOUTHAFRICA`). May differ from ISO 3166."}}}}}}
```

## The Contact object

```json
{"openapi":"3.1.0","info":{"title":"Agency API — Company Information","version":"2.0"},"components":{"schemas":{"Contact":{"type":"object","description":"An agency employee assigned to a key contact role.","properties":{"UserId":{"type":"string","description":"The impact.com numeric user ID of the assigned employee. Empty if no contact has been assigned to this role.\n\nTo resolve to a full user record, use the Users endpoint."},"Name":{"type":"string","description":"The contact's full display name. Empty if no contact is assigned."},"Email":{"type":"string","format":"email","description":"The contact's email address. Empty if no contact is assigned."},"WorkPhoneNumber":{"type":"string","description":"The contact's work phone number. Digits only. Empty if not set."},"WorkPhoneNumberCountry":{"type":"string","description":"The country associated with the work phone number."},"CellPhoneNumber":{"type":"string","description":"The contact's mobile phone number. Digits only. Empty if not set."},"CellPhoneNumberCountry":{"type":"string","description":"The country associated with the cell phone number."}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.impact.com/agency-v3/agency-v2/reference/account/models.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.