GetAccountResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-seller-central/main/json-schema/amazon-seller-central-get-account-response-schema.json",
  "title": "GetAccountResponse",
  "description": "The response schema for the `getAccount` operation.",
  "x-generated": "2026-09-24",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-seller-central-sellers-api-openapi.yml#/components/schemas/GetAccountResponse",
  "type": "object",
  "properties": {
    "payload": {
      "$ref": "#/$defs/Account"
    },
    "errors": {
      "description": "The errors encountered by the `getAccount` operation.",
      "$ref": "#/$defs/ErrorList"
    }
  },
  "$defs": {
    "Account": {
      "description": "The response schema for the `getAccount` operation.",
      "type": "object",
      "required": [
        "businessType",
        "sellingPlan",
        "marketplaceParticipationList"
      ],
      "properties": {
        "marketplaceParticipationList": {
          "$ref": "#/$defs/MarketplaceParticipationList"
        },
        "businessType": {
          "type": "string",
          "description": "The type of business registered for the seller account.",
          "enum": [
            "CHARITY",
            "CRAFTSMAN",
            "NATURAL_PERSON_COMPANY",
            "PUBLIC_LISTED",
            "PRIVATE_LIMITED",
            "SOLE_PROPRIETORSHIP",
            "STATE_OWNED",
            "INDIVIDUAL"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "CHARITY",
              "description": "The business is registered as a charity."
            },
            {
              "value": "CRAFTSMAN",
              "description": "The business is registered as a craftsman."
            },
            {
              "value": "NATURAL_PERSON_COMPANY",
              "description": "The business is a natural person company."
            },
            {
              "value": "PUBLIC_LISTED",
              "description": "The business is a publicly listed company."
            },
            {
              "value": "PRIVATE_LIMITED",
              "description": "The business is a private limited company."
            },
            {
              "value": "SOLE_PROPRIETORSHIP",
              "description": "The business is a sole proprietorship."
            },
            {
              "value": "STATE_OWNED",
              "description": "The business is state-owned."
            },
            {
              "value": "INDIVIDUAL",
              "description": "The entity is not a business but an individual."
            }
          ]
        },
        "sellingPlan": {
          "type": "string",
          "description": "The selling plan details.",
          "enum": [
            "PROFESSIONAL",
            "INDIVIDUAL"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "PROFESSIONAL",
              "description": "The seller has a professional selling plan."
            },
            {
              "value": "INDIVIDUAL",
              "description": "The seller has an individual selling plan."
            }
          ]
        },
        "business": {
          "$ref": "#/$defs/Business"
        },
        "primaryContact": {
          "$ref": "#/$defs/PrimaryContact"
        }
      }
    },
    "Address": {
      "type": "object",
      "description": "Represents an address",
      "required": [
        "addressLine1",
        "countryCode"
      ],
      "properties": {
        "addressLine1": {
          "type": "string",
          "description": "Street address information."
        },
        "addressLine2": {
          "type": "string",
          "description": "Additional street address information."
        },
        "countryCode": {
          "type": "string",
          "description": "The country code in two-character ISO 3166-1 alpha-2 format."
        },
        "stateOrProvinceCode": {
          "type": "string",
          "description": "The state or province code."
        },
        "city": {
          "type": "string",
          "description": "The city."
        },
        "postalCode": {
          "type": "string",
          "description": "The postal code."
        }
      }
    },
    "Business": {
      "type": "object",
      "description": "Information about the seller's business. Certain fields may be omitted depending on the seller's `businessType`.",
      "required": [
        "name",
        "registeredBusinessAddress"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "The registered business name."
        },
        "registeredBusinessAddress": {
          "$ref": "#/$defs/Address",
          "description": "The registered business address."
        },
        "companyRegistrationNumber": {
          "type": "string",
          "description": "The seller's company registration number, if applicable. This field will be absent for individual sellers and sole proprietorships."
        },
        "companyTaxIdentificationNumber": {
          "type": "string",
          "description": "The seller's company tax identification number, if applicable. This field will be present for certain business types only, such as sole proprietorships."
        },
        "nonLatinName": {
          "type": "string",
          "description": "The non-Latin script version of the registered business name, if applicable."
        }
      }
    },
    "Error": {
      "type": "object",
      "required": [
        "code",
        "message"
      ],
      "properties": {
        "code": {
          "type": "string",
          "description": "An error code that identifies the type of error that occurred."
        },
        "message": {
          "type": "string",
          "description": "A message that describes the error condition in a human-readable form."
        },
        "details": {
          "type": "string",
          "description": "Additional details that can help you understand or fix the issue."
        }
      },
      "description": "Error response returned when the request is unsuccessful."
    },
    "ErrorList": {
      "type": "array",
      "description": "A list of error responses returned when a request is unsuccessful.",
      "items": {
        "$ref": "#/$defs/Error"
      }
    },
    "Marketplace": {
      "type": "object",
      "required": [
        "id",
        "name",
        "countryCode",
        "defaultCurrencyCode",
        "defaultLanguageCode",
        "domainName"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The encrypted marketplace value."
        },
        "name": {
          "type": "string",
          "description": "The marketplace name."
        },
        "countryCode": {
          "type": "string",
          "description": "The ISO 3166-1 alpha-2 format country code of the marketplace.",
          "pattern": "^([A-Z]{2})$"
        },
        "defaultCurrencyCode": {
          "type": "string",
          "description": "The ISO 4217 format currency code of the marketplace."
        },
        "defaultLanguageCode": {
          "type": "string",
          "description": "The ISO 639-1 format language code of the marketplace."
        },
        "domainName": {
          "type": "string",
          "description": "The domain name of the marketplace."
        }
      },
      "description": "Information about an Amazon marketplace where a seller can list items and customers can view and purchase items."
    },
    "MarketplaceParticipation": {
      "type": "object",
      "required": [
        "marketplace",
        "participation",
        "storeName"
      ],
      "properties": {
        "marketplace": {
          "$ref": "#/$defs/Marketplace"
        },
        "participation": {
          "$ref": "#/$defs/Participation"
        },
        "storeName": {
          "type": "string",
          "description": "The name of the seller's store as displayed in the marketplace."
        }
      }
    },
    "MarketplaceParticipationList": {
      "type": "array",
      "description": "List of marketplace participations.",
      "items": {
        "$ref": "#/$defs/MarketplaceParticipation"
      }
    },
    "Participation": {
      "type": "object",
      "required": [
        "hasSuspendedListings",
        "isParticipating"
      ],
      "properties": {
        "isParticipating": {
          "type": "boolean",
          "description": "If `true`, the seller participates in the marketplace. Otherwise `false`."
        },
        "hasSuspendedListings": {
          "type": "boolean",
          "description": "Specifies if the seller has suspended listings. `true` if the seller Listing Status is set to Inactive, otherwise `false`."
        }
      },
      "description": "Information that is specific to a seller in a marketplace."
    },
    "PrimaryContact": {
      "type": "object",
      "description": "Information about the seller's primary contact.",
      "required": [
        "name",
        "address"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "The full name of the seller's primary contact."
        },
        "address": {
          "$ref": "#/$defs/Address",
          "description": "The primary contact's residential address."
        },
        "nonLatinName": {
          "type": "string",
          "description": "The non-Latin script version of the primary contact's name, if applicable."
        }
      }
    }
  }
}