{
    "openapi": "3.1.0",
    "info": {
      "title": "Identity API",
      "description": "<span class=\"tablenote\"><b>Note:</b> Not all the account related fields are returned for an authenticated user. The fields returned in the response are controlled by the scopes and are available only to select developers approved by business units.</span><br /><br />Retrieves the authenticated user's account profile information. It can be used to let users log into your app or site using eBay, which frees you from needing to store and protect user's PII (Personal Identifiable Information) data.",
      "contact": {
        "name": "eBay Inc,"
      },
      "license": {
        "name": "eBay API License Agreement",
        "url": "https://developer.ebay.com/join/api-license-agreement"
      },
      "version": "v2.0.0"
    },
    "servers": [
      {
        "url": "https://apiz.ebay.com{basePath}",
        "description": "Production",
        "variables": {
          "basePath": {
            "default": "/commerce/identity/v1"
          }
        }
      },
      {
        "url": "https://apiz.sandbox.ebay.com{basePath}",
        "description": "sandbox server",
        "variables": {
          "basePath": {
            "default": "/commerce/identity/v1"
          }
        }
      }
    ],
    "security": [
      {}
    ],
    "paths": {
      "/user/": {
        "get": {
          "tags": [
            "user"
          ],
          "description": "This method retrieves the account profile information for an authenticated user, which requires a <strong>User access token</strong>. What is returned is controlled by the <strong>scopes</strong>. <p>For a business account you use the default scope <code>commerce.identity.readonly</code>, which returns all the fields in the <strong>businessAccount</strong> container. These are returned because this is all public information.</p>  <p> For an individual account, the fields returned in the <strong>individualAccount</strong> container are based on the scope you use. Using the default scope, only public information, such as eBay user ID, are returned. For details about what each scope returns, see the <strong>Identity API scopes</strong>.</p>",
          "operationId": "getUser",
          "responses": {
            "200": {
              "description": "OK",
              "content": {
                "application/json": {
                  "schema": {
                    "$ref": "#/components/schemas/UserResponse"
                  }
                }
              }
            },
            "404": {
              "description": "Not Found",
              "content": {
                "application/json": {
                  "schema": {
                    "$ref": "#/components/schemas/Error"
                  }
                }
              },
              "x-response-codes": {
                "errors": {
                  "140001": {
                    "domain": "API_IDENTITY",
                    "category": "REQUEST",
                    "description": "The requested user was not found."
                  }
                }
              }
            },
            "500": {
              "description": "Internal Server Error",
              "content": {
                "application/json": {
                  "schema": {
                    "$ref": "#/components/schemas/Error"
                  }
                }
              },
              "x-response-codes": {
                "errors": {
                  "140000": {
                    "domain": "API_IDENTITY",
                    "category": "APPLICATION",
                    "description": "There was a problem with an eBay internal system or process. Contact eBay developer support for assistance."
                  }
                }
              }
            }
          },
          "security": [
            {
              "api_auth": [
                "https://api.ebay.com/oauth/api_scope/commerce.identity.readonly",
                "https://api.ebay.com/oauth/api_scope/commerce.identity.status.readonly",
                "https://api.ebay.com/oauth/api_scope/commerce.identity.name.readonly",
                "https://api.ebay.com/oauth/api_scope/commerce.identity.address.readonly",
                "https://api.ebay.com/oauth/api_scope/commerce.identity.email.readonly",
                "https://api.ebay.com/oauth/api_scope/commerce.identity.phone.readonly"
              ]
            }
          ]
        }
      }
    },
    "components": {
      "schemas": {
        "AccountTypeEnum": {
          "type": "object",
          "description": "An enumerated type for the values that represent the user's eBay account type. | - **INDIVIDUAL**: Indicates the eBay user's account is not a business but for an individual. - **BUSINESS**: Indicates the eBay user's account is for a business.",
          "enum": [
            "INDIVIDUAL",
            "BUSINESS"
          ]
        },
        "Address": {
          "type": "object",
          "properties": {
            "addressLine1": {
              "type": "string",
              "description": "The first line of the street address for the user's location."
            },
            "addressLine2": {
              "type": "string",
              "description": "The second line of the street address. This field is not always used, but can be used for 'Suite Number' or 'Apt Number'."
            },
            "city": {
              "type": "string",
              "description": "The city of the address."
            },
            "country": {
              "description": "The two-letter <a href=\"https://www.iso.org/iso-3166-country-codes.html\">ISO 3166</a> standard of the country of the address.",
              "$ref": "#/components/schemas/CountryCodeEnum"
            },
            "county": {
              "type": "string",
              "description": "The county of the address."
            },
            "postalCode": {
              "type": "string",
              "description": "The postal code of the address."
            },
            "stateOrProvince": {
              "type": "string",
              "description": "The state or province of the address."
            }
          },
          "description": "The type that defines the fields for an address."
        },
        "BusinessAccount": {
          "type": "object",
          "properties": {
            "address": {
              "description": "The business address associated with the user's eBay business account.",
              "$ref": "#/components/schemas/Address"
            },
            "doingBusinessAs": {
              "type": "string",
              "description": "An alternate business name or trade name used by the business on eBay."
            },
            "email": {
              "type": "string",
              "description": "The email address associated with the business account on eBay."
            },
            "name": {
              "type": "string",
              "description": "The official name of the business associated with the eBay user's account."
            },
            "primaryContact": {
              "description": "The container that returns the contact details of the person who is the primary contact for this account.",
              "$ref": "#/components/schemas/Contact"
            },
            "primaryPhone": {
              "description": "The container that returns the primary phone number for the business account.",
              "$ref": "#/components/schemas/Phone"
            },
            "secondaryPhone": {
              "description": "The container that returns the secondary phone number for the business account.",
              "$ref": "#/components/schemas/Phone"
            },
            "website": {
              "type": "string",
              "description": "The business website address associated with the eBay account."
            }
          },
          "description": "The type that defines the fields for the business account information."
        },
        "Contact": {
          "type": "object",
          "properties": {
            "firstName": {
              "type": "string",
              "description": "The first name of the contact person."
            },
            "lastName": {
              "type": "string",
              "description": "The last name of the contact person."
            }
          },
          "description": "The type that defines the fields for the information of the contact person for the account."
        },
        "CountryCodeEnum": {
          "type": "object",
          "description": "The two-letter ISO 3166 standard code representing a country. | - **AD**: Indicates the country is Andorra. - **AE**: Indicates the country is United Arab Emirates. - **AF**: Indicates the country is Afghanistan. - **AG**: Indicates the country is Antigua and Barbuda. - **AI**: Indicates the country is Anguilla. - **AL**: Indicates the country is Albania. - **AM**: Indicates the country is Armenia. - **AN**: Indicates the country is Netherlands Antilles. - **AO**: Indicates the country is Angola. - **AQ**: Indicates the country is Antarctica. - **AR**: Indicates the country is Argentina. - **AS**: Indicates the country is American Samoa. - **AT**: Indicates the country is Austria. - **AU**: Indicates the country is Australia. - **AW**: Indicates the country is Aruba. - **AX**: Indicates the country is Aland Islands - **AZ**: Indicates the country is Azerbaijan. - **BA**: Indicates the country is Bosnia and Herzegovina. - **BB**: Indicates the country is Barbados. - **BD**: Indicates the country is Bangladesh. - **BE**: Indicates the country is Belgium. - **BF**: Indicates the country is Burkina Faso. - **BG**: Indicates the country is Bulgaria. - **BH**: Indicates the country is Bahrain. - **BI**: Indicates the country is Burundi. - **BJ**: Indicates the country is Benin. - **BL**: Indicates the country is Saint Barthelemy. - **BM**: Indicates the country is Bermuda. - **BN**: Indicates the country is Brunei Darussalam. - **BO**: Indicates the country is Bolivia. - **BQ**: Indicates the country is Bonaire, Sint Eustatius, and Saba. - **BR**: Indicates the country is Brazil. - **BS**: Indicates the country is Bahamas. - **BT**: Indicates the country is Bhutan. - **BV**: Indicates the country is Bouvet Island. - **BW**: Indicates the country is Botswana. - **BY**: Indicates the country is Belarus. - **BZ**: Indicates the country is Belize. - **CA**: Indicates the country is Canada. - **CC**: Indicates the country is Cocos (Keeling) Islands. - **CD**: Indicates the country is The Democratic Republic of the Congo. - **CF**: Indicates the country is Central African Republic. - **CG**: Indicates the country is Congo. - **CH**: Indicates the country is Switzerland. - **CI**: Indicates the country is Cote d'Ivoire. - **CK**: Indicates the country is Cook Islands. - **CL**: Indicates the country is Chile. - **CM**: Indicates the country is Cameroon. - **CN**: Indicates the country is China. - **CO**: Indicates the country is Colombia. - **CR**: Indicates the country is Costa Rica. - **CU**: Indicates the country is Cuba. - **CV**: Indicates the country is Cape Verde. - **CW**: Indicates the country is Curacao. - **CX**: Indicates the country is Christmas Island. - **CY**: Indicates the country is Cyprus. - **CZ**: Indicates the country is Czech Republic. - **DE**: Indicates the country is Germany. - **DJ**: Indicates the country is Djibouti. - **DK**: Indicates the country is Denmark. - **DM**: Indicates the country is Dominica. - **DO**: Indicates the country is Dominican Republic. - **DZ**: Indicates the country is Algeria. - **EC**: Indicates the country is Ecuador. - **EE**: Indicates the country is Estonia. - **EG**: Indicates the country is Egypt. - **EH**: Indicates the country is Western Sahara. - **ER**: Indicates the country is Eritrea. - **ES**: Indicates the country is Spain. - **ET**: Indicates the country is Ethiopia. - **FI**: Indicates the country is Finland. - **FJ**: Indicates the country is Fiji. - **FK**: Indicates the country is Falkland Islands (Malvinas). - **FM**: Indicates the country is Federated States of Micronesia. - **FO**: Indicates the country is Faroe Islands. - **FR**: Indicates the country is France. - **GA**: Indicates the country is Gabon. - **GB**: Indicates the country is United Kingdom. - **GD**: Indicates the country is Grenada. - **GE**: Indicates the country is Georgia. - **GF**: Indicates the country is French Guiana. - **GG**: Indicates the country is Guernsey. - **GH**: Indicates the country is Ghana. - **GI**: Indicates the country is Gibraltar. - **GL**: Indicates the country is Greenland. - **GM**: Indicates the country is Gambia. - **GN**: Indicates the country is Guinea. - **GP**: Indicates the country is Guadeloupe. - **GQ**: Indicates the country is Equatorial Guinea. - **GR**: Indicates the country is Greece. - **GS**: Indicates the country is South Georgia and the South Sandwich Islands. - **GT**: Indicates the country is Guatemala. - **GU**: Indicates the country is Guam. - **GW**: Indicates the country is Guinea-Bissau. - **GY**: Indicates the country is Guyana. - **HK**: Indicates the country is Hong Kong. - **HM**: Indicates the country is Heard Island and McDonald Islands. - **HN**: Indicates the country is Honduras. - **HR**: Indicates the country is Croatia. - **HT**: Indicates the country is Haiti. - **HU**: Indicates the country is Hungary. - **ID**: Indicates the country is Indonesia. - **IE**: Indicates the country is Ireland. - **IL**: Indicates the country is Israel. - **IM**: Indicates the country is Isle of Man. - **IN**: Indicates the country is India. - **IO**: Indicates the country is British Indian Ocean Territory. - **IQ**: Indicates the country is Iraq. - **IR**: Indicates the country is Islamic Republic of Iran. - **IS**: Indicates the country is Iceland. - **IT**: Indicates the country is Italy. - **JE**: Indicates the country is Jersey. - **JM**: Indicates the country is Jamaica. - **JO**: Indicates the country is Jordan. - **JP**: Indicates the country is Japan. - **KE**: Indicates the country is Kenya. - **KG**: Indicates the country is Kyrgyzstan. - **KH**: Indicates the country is Cambodia. - **KI**: Indicates the country is Kiribati. - **KM**: Indicates the country is Comoros. - **KN**: Indicates the country is Saint Kitts and Nevis. - **KP**: Indicates the country is Democratic People's Republic of Korea. - **KR**: Indicates the country is Republic of Korea. - **KW**: Indicates the country is Kuwait. - **KY**: Indicates the country is Cayman Islands. - **KZ**: Indicates the country is Kazakhstan. - **LA**: Indicates the country is Lao People's Democratic Republic. - **LB**: Indicates the country is Lebanon. - **LC**: Indicates the country is Saint Lucia. - **LI**: Indicates the country is Liechtenstein. - **LK**: Indicates the country is Sri Lanka. - **LR**: Indicates the country is Liberia. - **LS**: Indicates the country is Lesotho. - **LT**: Indicates the country is Lithuania. - **LU**: Indicates the country is Luxembourg. - **LV**: Indicates the country is Latvia. - **LY**: Indicates the country is Libyan Arab Jamahiriya. - **MA**: Indicates the country is Morocco. - **MC**: Indicates the country is Monaco. - **MD**: Indicates the country is Republic of Moldova. - **ME**: Indicates the country is Montenegro. - **MF**: Indicates the country is Saint Martin (French part). - **MG**: Indicates the country is Madagascar. - **MH**: Indicates the country is Marshall Islands. - **MK**: Indicates the country is The Former Yugoslav Republic of Macedonia. - **ML**: Indicates the country is Mali. - **MM**: Indicates the country is Myanmar. - **MN**: Indicates the country is Mongolia. - **MO**: Indicates the country is Macao. - **MP**: Indicates the country is Northern Mariana Islands. - **MQ**: Indicates the country is Martinique. - **MR**: Indicates the country is Mauritania. - **MS**: Indicates the country is Montserrat. - **MT**: Indicates the country is Malta. - **MU**: Indicates the country is Mauritius. - **MV**: Indicates the country is Maldives. - **MW**: Indicates the country is Malawi. - **MX**: Indicates the country is Mexico. - **MY**: Indicates the country is Malaysia. - **MZ**: Indicates the country is Mozambique. - **NA**: Indicates the country is Namibia. - **NC**: Indicates the country is New Caledonia. - **NE**: Indicates the country is Niger. - **NF**: Indicates the country is Norfolk Island. - **NG**: Indicates the country is Nigeria. - **NI**: Indicates the country is Nicaragua. - **NL**: Indicates the country is Netherlands. - **NO**: Indicates the country is Norway. - **NP**: Indicates the country is Nepal. - **NR**: Indicates the country is Nauru. - **NU**: Indicates the country is Niue. - **NZ**: Indicates the country is New Zealand. - **OM**: Indicates the country is Oman. - **PA**: Indicates the country is Panama. - **PE**: Indicates the country is Peru. - **PF**: Indicates the country is French Polynesia. Includes Tahiti. - **PG**: Indicates the country is Papua New Guinea. - **PH**: Indicates the country is Philippines. - **PK**: Indicates the country is Pakistan. - **PL**: Indicates the country is Poland. - **PM**: Indicates the country is Saint Pierre and Miquelon. - **PN**: Indicates the country is Pitcairn. - **PR**: Indicates the country is Puerto Rico. - **PS**: Indicates the country is Palestinian territory Occupied. - **PT**: Indicates the country is Portugal. - **PW**: Indicates the country is Palau. - **PY**: Indicates the country is Paraguay. - **QA**: Indicates the country is Qatar. - **RE**: Indicates the country is Reunion. - **RO**: Indicates the country is Romania. - **RS**: Indicates the country is Serbia. - **RU**: Indicates the country is Russian Federation. - **RW**: Indicates the country is Rwanda. - **SA**: Indicates the country is Saudi Arabia. - **SB**: Indicates the country is Solomon Islands. - **SC**: Indicates the country is Seychelles. - **SD**: Indicates the country is Sudan. - **SE**: Indicates the country is Sweden. - **SG**: Indicates the country is Singapore. - **SH**: Indicates the country is Saint Helena. - **SI**: Indicates the country is Slovenia. - **SJ**: Indicates the country is Svalbard and Jan Mayen. - **SK**: Indicates the country is Slovakia. - **SL**: Indicates the country is Sierra Leone. - **SM**: Indicates the country is San Marino. - **SN**: Indicates the country is Senegal. - **SO**: Indicates the country is Somalia. - **SR**: Indicates the country is Suriname. - **SS**: Indicates the country is South Sudan. - **ST**: Indicates the country is Sao Tome and Principe. - **SV**: Indicates the country is El Salvador. - **SX**: Indicates the country is Sint Maarten (Dutch part). - **SY**: Indicates the country is Syrian Arab Republic. - **SZ**: Indicates the country is Swaziland. - **TC**: Indicates the country is Turks and Caicos Islands. - **TD**: Indicates the country is Chad. - **TF**: Indicates the country is French Southern Territories. - **TG**: Indicates the country is Togo. - **TH**: Indicates the country is Thailand. - **TJ**: Indicates the country is Tajikistan. - **TK**: Indicates the country is Tokelau. - **TL**: Indicates the country is Timor-Leste. - **TM**: Indicates the country is Turkmenistan. - **TN**: Indicates the country is Tunisia. - **TO**: Indicates the country is Tonga. - **TR**: Indicates the country is Turkey. - **TT**: Indicates the country is Trinidad and Tobago. - **TV**: Indicates the country is Tuvalu. - **TW**: Indicates the country is Taiwan. - **TZ**: Indicates the country is Tanzania. - **UA**: Indicates the country is Ukraine. - **UG**: Indicates the country is Uganda. - **UM**: Indicates the country is United States Minor Outlying Islands. - **US**: Indicates the country is United States. - **UY**: Indicates the country is Uruguay. - **UZ**: Indicates the country is Uzbekistan. - **VA**: Indicates the country is Holy See (Vatican City state). - **VC**: Indicates the country is Saint Vincent and the Grenadines. - **VE**: Indicates the country is Venezuela. - **VG**: Indicates the country is British Virgin Islands. - **VI**: Indicates the country is the U.S. Virgin Islands. - **VN**: Indicates the country is Vietnam. - **VU**: Indicates the country is Vanuatu. - **WF**: Indicates the country is Wallis and Futuna. - **WS**: Indicates the country is Samoa. - **YE**: Indicates the country is Yemen. - **YT**: Indicates the country is Mayotte. - **ZA**: Indicates the country is South Africa. - **ZM**: Indicates the country is Zambia. - **ZW**: Indicates the country is Zimbabwe.",
          "enum": [
            "AD",
            "AE",
            "AF",
            "AG",
            "AI",
            "AL",
            "AM",
            "AN",
            "AO",
            "AQ",
            "AR",
            "AS",
            "AT",
            "AU",
            "AW",
            "AX",
            "AZ",
            "BA",
            "BB",
            "BD",
            "BE",
            "BF",
            "BG",
            "BH",
            "BI",
            "BJ",
            "BL",
            "BM",
            "BN",
            "BO",
            "BQ",
            "BR",
            "BS",
            "BT",
            "BV",
            "BW",
            "BY",
            "BZ",
            "CA",
            "CC",
            "CD",
            "CF",
            "CG",
            "CH",
            "CI",
            "CK",
            "CL",
            "CM",
            "CN",
            "CO",
            "CR",
            "CU",
            "CV",
            "CW",
            "CX",
            "CY",
            "CZ",
            "DE",
            "DJ",
            "DK",
            "DM",
            "DO",
            "DZ",
            "EC",
            "EE",
            "EG",
            "EH",
            "ER",
            "ES",
            "ET",
            "FI",
            "FJ",
            "FK",
            "FM",
            "FO",
            "FR",
            "GA",
            "GB",
            "GD",
            "GE",
            "GF",
            "GG",
            "GH",
            "GI",
            "GL",
            "GM",
            "GN",
            "GP",
            "GQ",
            "GR",
            "GS",
            "GT",
            "GU",
            "GW",
            "GY",
            "HK",
            "HM",
            "HN",
            "HR",
            "HT",
            "HU",
            "ID",
            "IE",
            "IL",
            "IM",
            "IN",
            "IO",
            "IQ",
            "IR",
            "IS",
            "IT",
            "JE",
            "JM",
            "JO",
            "JP",
            "KE",
            "KG",
            "KH",
            "KI",
            "KM",
            "KN",
            "KP",
            "KR",
            "KW",
            "KY",
            "KZ",
            "LA",
            "LB",
            "LC",
            "LI",
            "LK",
            "LR",
            "LS",
            "LT",
            "LU",
            "LV",
            "LY",
            "MA",
            "MC",
            "MD",
            "ME",
            "MF",
            "MG",
            "MH",
            "MK",
            "ML",
            "MM",
            "MN",
            "MO",
            "MP",
            "MQ",
            "MR",
            "MS",
            "MT",
            "MU",
            "MV",
            "MW",
            "MX",
            "MY",
            "MZ",
            "NA",
            "NC",
            "NE",
            "NF",
            "NG",
            "NI",
            "NL",
            "NO",
            "NP",
            "NR",
            "NU",
            "NZ",
            "OM",
            "PA",
            "PE",
            "PF",
            "PG",
            "PH",
            "PK",
            "PL",
            "PM",
            "PN",
            "PR",
            "PS",
            "PT",
            "PW",
            "PY",
            "QA",
            "RE",
            "RO",
            "RS",
            "RU",
            "RW",
            "SA",
            "SB",
            "SC",
            "SD",
            "SE",
            "SG",
            "SH",
            "SI",
            "SJ",
            "SK",
            "SL",
            "SM",
            "SN",
            "SO",
            "SR",
            "SS",
            "ST",
            "SV",
            "SX",
            "SY",
            "SZ",
            "TC",
            "TD",
            "TF",
            "TG",
            "TH",
            "TJ",
            "TK",
            "TL",
            "TM",
            "TN",
            "TO",
            "TR",
            "TT",
            "TV",
            "TW",
            "TZ",
            "UA",
            "UG",
            "UM",
            "US",
            "UY",
            "UZ",
            "VA",
            "VC",
            "VE",
            "VG",
            "VI",
            "VN",
            "VU",
            "WF",
            "WS",
            "YE",
            "YT",
            "ZA",
            "ZM",
            "ZW"
          ]
        },
        "Error": {
          "type": "object",
          "properties": {
            "category": {
              "type": "string",
              "description": "Indicates the classification of the error, such as whether it is a problem with the request, application, or system."
            },
            "domain": {
              "type": "string",
              "description": "The primary system or service where the error originated. This information is especially relevant for identifying the source of application errors."
            },
            "errorId": {
              "type": "integer",
              "description": "A unique identifier assigned to each specific error, useful for debugging and support.",
              "format": "int32"
            },
            "inputRefIds": {
              "type": "array",
              "description": "An array of request element identifiers most closely associated with the cause of the error.",
              "items": {
                "type": "string"
              }
            },
            "longMessage": {
              "type": "string",
              "description": "A longer, more detailed explanation of the error that occurred. This message provides additional context to help with troubleshooting."
            },
            "message": {
              "type": "string",
              "description": "Information on how to correct the problem, in the end user's terms and language where applicable."
            },
            "outputRefIds": {
              "type": "array",
              "description": "An array of response elements that are most closely associated with the error, providing additional context for debugging. Hello, this is a test.",
              "items": {
                "type": "string"
              }
            },
            "parameters": {
              "type": "array",
              "description": "An array of name/value pairs that provide details about the error condition, useful when multiple errors are returned.",
              "items": {
                "$ref": "#/components/schemas/ErrorParameter"
              }
            },
            "subdomain": {
              "type": "string",
              "description": "Provides additional information about the subsystem where the error occurred, such as Initialization, Security, or Rate Limiting."
            }
          },
          "description": "This type defines the fields that can be returned in an error."
        },
        "ErrorParameter": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "The name of the request field or entity associated with the error detail.",
              "examples": [
                "categoryId"
              ]
            },
            "value": {
              "type": "string",
              "description": "The value associated with the parameter name that provides specific details about the error.",
              "examples": [
                "1234"
              ]
            }
          },
          "description": "This type contains a name-value pair that provides additional details about the error, useful for conveying which request elements were involved."
        },
        "IndividualAccount": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string",
              "description": "The eBay user's registration email address."
            },
            "firstName": {
              "type": "string",
              "description": "The eBay user's first name."
            },
            "lastName": {
              "type": "string",
              "description": "The eBay user's last name."
            },
            "primaryPhone": {
              "description": "The primary phone number associated with the individual account, if available.",
              "$ref": "#/components/schemas/Phone"
            },
            "registrationAddress": {
              "description": "The container that returns the eBay user's address information.",
              "$ref": "#/components/schemas/Address"
            },
            "secondaryPhone": {
              "description": "A secondary phone number registered with the individual eBay account.",
              "$ref": "#/components/schemas/Phone"
            }
          },
          "description": "The type that defines the fields for information about an individual eBay account."
        },
        "MarketplaceIdEnum": {
          "type": "object",
          "description": "An enumerated type for the values that represent the unique eBay-assigned IDs for each of the eBay marketplaces. | - **EBAY_AT**: Indicates the eBay marketplace for Austria (https://www.ebay.at). - **EBAY_AU**: Indicates the eBay marketplace for Australia (https://www.ebay.com.au). - **EBAY_BE**: Indicates the eBay marketplace for Belgium (https://www.ebay.be/). - **EBAY_CA**: Indicates the eBay marketplace for Canada (https://www.ebay.ca). - **EBAY_CH**: Indicates the eBay marketplace for Switzerland (https://www.ebay.ch). - **EBAY_CN**: Reserved for future use. - **EBAY_CZ**: Reserved for future use. - **EBAY_DE**: Indicates the eBay marketplace for Germany (https://www.ebay.de). - **EBAY_DK**: Reserved for future use. - **EBAY_ES**: Indicates the eBay marketplace for Spain (https://www.ebay.es). - **EBAY_FI**: Reserved for future use. - **EBAY_FR**: Indicates the eBay marketplace for France (https://www.ebay.fr). - **EBAY_GB**: Indicates the eBay marketplace for Great Britain (https://www.ebay.co.uk). - **EBAY_GR**: Reserved for future use. - **EBAY_HK**: Indicates the eBay marketplace for Hong Kong (https://www.ebay.com.hk). - **EBAY_HU**: Reserved for future use. - **EBAY_ID**: Reserved for future use. - **EBAY_IE**: Indicates the eBay marketplace for Ireland (https://www.ebay.ie). - **EBAY_IL**: Reserved for future use. - **EBAY_IN**: Indicates the eBay marketplace for India (https://www.ebay.in). - **EBAY_IT**: Indicates the eBay marketplace for Italy (https://www.ebay.it). - **EBAY_JP**: Reserved for future use. - **EBAY_MY**: Indicates the eBay marketplace for Malaysia (https://www.ebay.com.my). - **EBAY_NL**: Indicates the eBay marketplace for the Netherlands (https://www.ebay.nl). - **EBAY_NO**: Reserved for future use. - **EBAY_NZ**: Reserved for future use. - **EBAY_PE**: Reserved for future use. - **EBAY_PH**: Indicates the eBay marketplace for the Philippines (https://www.ebay.ph). - **EBAY_PL**: Indicates the eBay marketplace for Poland (https://www.ebay.pl). - **EBAY_PR**: Reserved for future use. - **EBAY_PT**: Reserved for future use. - **EBAY_RU**: Reserved for future use. - **EBAY_SE**: Reserved for future use. - **EBAY_SG**: Indicates the eBay marketplace for Singapore (https://www.ebay.com.sg). - **EBAY_TH**: Indicates the eBay marketplace for Thailand (https://info.ebay.co.th). - **EBAY_TW**: Indicates the eBay marketplace for Taiwan (https://www.ebay.com.tw). - **EBAY_US**: Indicates the eBay marketplace for the United States (https://www.ebay.com). - **EBAY_VN**: Indicates the eBay marketplace for Vietnam (https://www.ebay.vn). - **EBAY_ZA**: Reserved for future use. - **EBAY_HALF_US**: No longer used. - **EBAY_MOTORS_US**: Indicates the parent category for \"Auto Parts and Vehicles\" on the EBAY_US marketplace (https://www.ebay.com/motors).",
          "enum": [
            "EBAY_AT",
            "EBAY_AU",
            "EBAY_BE",
            "EBAY_CA",
            "EBAY_CH",
            "EBAY_CN",
            "EBAY_CZ",
            "EBAY_DE",
            "EBAY_DK",
            "EBAY_ES",
            "EBAY_FI",
            "EBAY_FR",
            "EBAY_GB",
            "EBAY_GR",
            "EBAY_HK",
            "EBAY_HU",
            "EBAY_ID",
            "EBAY_IE",
            "EBAY_IL",
            "EBAY_IN",
            "EBAY_IT",
            "EBAY_JP",
            "EBAY_MY",
            "EBAY_NL",
            "EBAY_NO",
            "EBAY_NZ",
            "EBAY_PE",
            "EBAY_PH",
            "EBAY_PL",
            "EBAY_PR",
            "EBAY_PT",
            "EBAY_RU",
            "EBAY_SE",
            "EBAY_SG",
            "EBAY_TH",
            "EBAY_TW",
            "EBAY_US",
            "EBAY_VN",
            "EBAY_ZA",
            "EBAY_HALF_US",
            "EBAY_MOTORS_US"
          ]
        },
        "Phone": {
          "type": "object",
          "properties": {
            "countryCode": {
              "type": "string",
              "description": "The two-letter <a href=\"https://www.iso.org/iso-3166-country-codes.html\">ISO 3166</a> standard of the country to which the phone number belongs."
            },
            "number": {
              "type": "string",
              "description": "The numeric string representing the phone number."
            },
            "phoneType": {
              "type": "string",
              "description": "The type of phone service. <br /><br /><b> Valid Values: </b> MOBILE or LAND_LINE  <br /><br />Code so that your app gracefully handles any future changes to this list."
            }
          },
          "description": "The type that defines the fields for the details of a phone."
        },
        "UserResponse": {
          "type": "object",
          "required": [
            "accountType",
            "registrationMarketplaceId",
            "status",
            "userId",
            "username"
          ],
          "properties": {
            "accountType": {
              "description": "Indicates the user account type. This is determined when the user registers with eBay. If they register for a business account, this value will be <code>BUSINESS</code>. If they register for a private account, this value will be <code>INDIVIDUAL</code>. This designation is required by the tax laws in the following countries:   <ul><li>EBAY_AT</li><li>EBAY_BE</li><li>EBAY_CH</li><li>EBAY_DE</li><li>EBAY_ES</li><li>EBAY_FR</li><li>EBAY_GB</li><li>EBAY_IE</li><li>EBAY_IT</li><li>EBAY_PL</li></ul> <br /><b> Valid Values:</b> <code>BUSINESS</code> or <code>INDIVIDUAL</code> <br /><br />Code so that your app gracefully handles any future changes to this list.",
              "$ref": "#/components/schemas/AccountTypeEnum"
            },
            "businessAccount": {
              "description": "The container that returns the business account information of the user.",
              "$ref": "#/components/schemas/BusinessAccount"
            },
            "individualAccount": {
              "description": "The account information of the user.",
              "$ref": "#/components/schemas/IndividualAccount"
            },
            "registrationMarketplaceId": {
              "description": "The unique identifier for the eBay marketplace in which the user registered their account.",
              "$ref": "#/components/schemas/MarketplaceIdEnum"
            },
            "status": {
              "description": "The current status of the user's eBay account, such as whether it is confirmed, unconfirmed, on hold, or undetermined.",
              "$ref": "#/components/schemas/UserStatusEnum"
            },
            "userId": {
              "type": "string",
              "description": "The eBay immutable user ID of the user's account and can always be used to identify the user."
            },
            "username": {
              "type": "string",
              "description": "The user name, which was specified by the user when they created the account. <br /><br /><span class=\"tablenote\"><b>Note: </b> This value can be changed by the user.</span><br><span class=\"tablenote\"><b>Note:</b> Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href=\"/api-docs/static/data-handling-update.html\">Data Handling Compliance</a>. </span>"
            }
          },
          "description": "The type that defines the fields for the <b>getUser</b> method."
        },
        "UserStatusEnum": {
          "type": "object",
          "description": "An enumerated type for the values that represent the status of the user's account. | - **CONFIRMED**: Indicates the user's account has been verified by eBay. - **UNCONFIRMED**: Indicates the user's account has not been verified by eBay. - **ACCOUNTONHOLD**: Indicates the user's account has been put on hold by eBay. - **UNDETERMINED**: Indicates the user's account is not in any of the other states.",
          "enum": [
            "CONFIRMED",
            "UNCONFIRMED",
            "ACCOUNTONHOLD",
            "UNDETERMINED"
          ]
        }
      },
      "securitySchemes": {
        "api_auth": {
          "type": "oauth2",
          "description": "The security definitions for this API. Please check individual operations for applicable scopes.",
          "flows": {
            "authorizationCode": {
              "authorizationUrl": "https://auth.ebay.com/oauth2/authorize",
              "tokenUrl": "https://api.ebay.com/identity/v1/oauth2/token",
              "scopes": {
                "https://api.ebay.com/oauth/api_scope/commerce.identity.email.readonly": "View a user's personal email information from their eBay member account",
                "https://api.ebay.com/oauth/api_scope/commerce.identity.status.readonly": "View a user's eBay member account status",
                "https://api.ebay.com/oauth/api_scope/commerce.identity.address.readonly": "View a user's personal address information from their eBay member account",
                "https://api.ebay.com/oauth/api_scope/commerce.identity.readonly": "View a user's basic information, such as username or business account details, from their eBay member account",
                "https://api.ebay.com/oauth/api_scope/commerce.identity.name.readonly": "View a user's first and last name from their eBay member account",
                "https://api.ebay.com/oauth/api_scope/commerce.identity.phone.readonly": "View a user's personal telephone information from their eBay member account",
                "ebayUser": "This scope would allow signed in user to read their eBay user profile data."
              }
            }
          }
        },
        "bearerAuth": {
          "type": "http",
          "scheme": "bearer"
        }
      }
    }
  }