---
name: identity-api
description: "Identity API skill. Use when working with Identity for user. Covers 1 endpoint."
version: 1.0.0
generator: lapsh
---

# Identity API
API version: v2.0.0

## Auth
OAuth2

## Base URL
https://apiz.ebay.com/commerce/identity/v1

## Setup
1. Configure auth: OAuth2
2. GET /user/ -- 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.
3. Explore available endpoints below

## Endpoints
1 endpoint across 1 group. See references/api-spec.lap for full details.

### User
| Method | Path | Description |
|--------|------|-------------|
| GET | /user/ | 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. |

## Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "List all user?" -> GET /user/
- "How to authenticate?" -> See Auth section above

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Error responses include status codes and descriptions in the spec

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)