# REST Resource: freelistingsprogram

- [Resource: FreeListingsProgramStatus](https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#FreeListingsProgramStatus)
  - [JSON representation](https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#FreeListingsProgramStatus.SCHEMA_REPRESENTATION)
- [ProgramState](https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#ProgramState)
- [RegionStatus](https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#RegionStatus)
  - [JSON representation](https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#RegionStatus.SCHEMA_REPRESENTATION)
- [ReviewIneligibilityReasonDetails](https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#ReviewIneligibilityReasonDetails)
  - [JSON representation](https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#ReviewIneligibilityReasonDetails.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#METHODS_SUMMARY)

## Resource: FreeListingsProgramStatus

Response message for freelistingsprogram.get.

| JSON representation |
|---|
| ``` { "globalState": enum (`https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#ProgramState`), "regionStatuses": [ { object (`https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#RegionStatus`) } ] } ``` |

| Fields ||
|---|---|
| `globalState` | ``enum (`https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#ProgramState`)`` State of the program. `ENABLED` if there are offers for at least one region. |
| `regionStatuses[]` | ``object (`https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#RegionStatus`)`` Status of the program in each region. Regions with the same status and review eligibility are grouped together in `regionCodes`. |

## ProgramState

Different states of the program for the account.

| Enums ||
|---|---|
| `PROGRAM_STATE_UNSPECIFIED` | State is unknown. |
| `NOT_ENABLED` | Program is not enabled for any country. |
| `NO_OFFERS_UPLOADED` | No products have been uploaded for any region. Upload products to Merchant Center. |
| `ENABLED` | Program is enabled and offers are uploaded for at least one country. |

## RegionStatus

Status of program and region.

| JSON representation |
|---|
| ``` { "regionCodes": [ string ], "eligibilityStatus": enum (`https://developers.google.com/shopping-content/reference/rest/v2.1/State`), "reviewIssues": [ string ], "onboardingIssues": [ string ], "disapprovalDate": string, "reviewEligibilityStatus": enum (`https://developers.google.com/shopping-content/reference/rest/v2.1/ReviewEligibility`), "reviewIneligibilityReason": enum (`https://developers.google.com/shopping-content/reference/rest/v2.1/ReviewIneligibilityReason`), "reviewIneligibilityReasonDescription": string, "reviewIneligibilityReasonDetails": { object (`https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#ReviewIneligibilityReasonDetails`) } } ``` |

| Fields ||
|---|---|
| `regionCodes[]` | `string` The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) codes for all the regions with the same `eligibilityStatus` and `reviewEligibility`. |
| `eligibilityStatus` | ``enum (`https://developers.google.com/shopping-content/reference/rest/v2.1/State`)`` Eligibility status of the standard free listing program. |
| `reviewIssues[]` | `string` Issues evaluated in the review process. Fix all issues before requesting a review. |
| `onboardingIssues[]` | `string` Issues that must be fixed to be eligible for review. |
| `disapprovalDate` | `string` Date by which eligibilityStatus will go from `WARNING` to `DISAPPROVED`. Only visible when your eligibilityStatus is WARNING. In [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DD`. |
| `reviewEligibilityStatus` | ``enum (`https://developers.google.com/shopping-content/reference/rest/v2.1/ReviewEligibility`)`` If a program is eligible for review in a specific region. Only visible if `eligibilityStatus` is `DISAPPROVED`. |
| `reviewIneligibilityReason` | ``enum (`https://developers.google.com/shopping-content/reference/rest/v2.1/ReviewIneligibilityReason`)`` Review ineligibility reason if account is not eligible for review. |
| `reviewIneligibilityReasonDescription` | `string` Reason a program in a specific region isn't eligible for review. Only visible if `reviewEligibilityStatus` is `INELIGIBLE`. |
| `reviewIneligibilityReasonDetails` | ``object (`https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram#ReviewIneligibilityReasonDetails`)`` Additional information for ineligibility. If `reviewIneligibilityReason` is `IN_COOLDOWN_PERIOD`, a timestamp for the end of the cooldown period is provided. |

## ReviewIneligibilityReasonDetails

Additional details for review ineligibility reasons.

| JSON representation |
|---|
| ``` { "cooldownTime": string } ``` |

| Fields ||
|---|---|
| `cooldownTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` This timestamp represents end of cooldown period for review ineligbility reason `IN_COOLDOWN_PERIOD`. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram/get` | Retrieves the status and review eligibility for the free listing program. |
| ### `https://developers.google.com/shopping-content/reference/rest/v2.1/freelistingsprogram/requestreview` | Requests a review of free listings in a specific region. |