@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Identity API
@base https://apiz.ebay.com/commerce/identity/v1
@version v2.0.0
@auth OAuth2
@endpoints 1
@toc user(1)

@endpoint GET /user/
@desc This method retrieves the account profile information for an authenticated user, which requires a User access token. What is returned is controlled by the scopes. For a business account you use the default scope commerce.identity.readonly, which returns all the fields in the businessAccount container. These are returned  because this is all public information.   For an individual account, the fields returned in the individualAccount 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 Identity API Overview. In the Sandbox, this API returns mock data. Note:  You must use the correct scope or scopes for the data you want returned.
@returns(200) {accountType: str, businessAccount: map{address: map{addressLine1: str, addressLine2: str, city: str, country: str, county: str, postalCode: str, stateOrProvince: str}, doingBusinessAs: str, email: str, name: str, primaryContact: map{firstName: str, lastName: str}, primaryPhone: map{countryCode: str, number: str, phoneType: str}, secondaryPhone: map{countryCode: str, number: str, phoneType: str}, website: str}, individualAccount: map{email: str, firstName: str, lastName: str, primaryPhone: map{countryCode: str, number: str, phoneType: str}, registrationAddress: map{addressLine1: str, addressLine2: str, city: str, country: str, county: str, postalCode: str, stateOrProvince: str}, secondaryPhone: map{countryCode: str, number: str, phoneType: str}}, registrationMarketplaceId: str, status: str, userId: str, username: str} # OK
@errors {404: Not found, 500: Internal Server Error}

@end