# REST Resource: accounts.businessIdentity

- [Resource: BusinessIdentity](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#BusinessIdentity)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#BusinessIdentity.SCHEMA_REPRESENTATION)
- [PromotionsConsent](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#PromotionsConsent)
- [IdentityAttribute](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute.SCHEMA_REPRESENTATION)
- [IdentityDeclaration](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityDeclaration)
- [Methods](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#METHODS_SUMMARY)

## Resource: BusinessIdentity

Collection of information related to the [identity of a business](https://support.google.com/merchants/answer/12564247).

| JSON representation |
|---|
| ``` { "name": string, "promotionsConsent": enum (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#PromotionsConsent`), "blackOwned": { object (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute`) }, "womenOwned": { object (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute`) }, "veteranOwned": { object (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute`) }, "latinoOwned": { object (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute`) }, "smallBusiness": { object (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the business identity. Format: `accounts/{account}/businessIdentity` |
| `promotionsConsent` | ``enum (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#PromotionsConsent`)`` Required. Whether the identity attributes may be used for promotions. |
| `blackOwned` | ``object (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute`)`` Optional. Specifies whether the business identifies itself as being black-owned. This optional field will only be available for businesses with the business country set to `US`. It is also not applicable for marketplaces or marketplace sellers. |
| `womenOwned` | ``object (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute`)`` Optional. Specifies whether the business identifies itself as being women-owned. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces or marketplace sellers. |
| `veteranOwned` | ``object (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute`)`` Optional. Specifies whether the business identifies itself as being veteran-owned. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces or marketplace sellers. |
| `latinoOwned` | ``object (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute`)`` Optional. Specifies whether the business identifies itself as being latino-owned. This optional field will only be available for businesses with the business country set to `US`. It is also not applicable for marketplaces or marketplace sellers. |
| `smallBusiness` | ``object (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityAttribute`)`` Optional. Specifies whether the business identifies itself as a small business. This optional field will only be available for businesses with a business country set to `US`. It is also not applicable for marketplaces. |

## PromotionsConsent

All possible settings regarding promotions related to the business identity.

| Enums ||
|---|---|
| `PROMOTIONS_CONSENT_UNSPECIFIED` | Default value indicating that no selection was made. |
| `PROMOTIONS_CONSENT_GIVEN` | Indicates that the account consented to having their business identity used for promotions. |
| `PROMOTIONS_CONSENT_DENIED` | Indicates that the account did not consent to having their business identity used for promotions. |

## IdentityAttribute

All information related to an identity attribute.

| JSON representation |
|---|
| ``` { "identityDeclaration": enum (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityDeclaration`) } ``` |

| Fields ||
|---|---|
| `identityDeclaration` | ``enum (`https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity#IdentityDeclaration`)`` Required. The declaration of identity for this attribute. |

## IdentityDeclaration

All possible settings regarding the declaration of an identity.

| Enums ||
|---|---|
| `IDENTITY_DECLARATION_UNSPECIFIED` | Default value indicating that no selection was made. |
| `SELF_IDENTIFIES_AS` | Indicates that the account identifies with the attribute. |
| `DOES_NOT_SELF_IDENTIFY_AS` | Indicates that the account does not identify with the attribute. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity/getBusinessIdentity` | Retrieves the business identity of an account. |
| ### `https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessIdentity/updateBusinessIdentity` | Updates the business identity of an account. |