> For the complete documentation index, see [llms.txt](https://developers.yumpu.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.yumpu.com/api/user/userget.md).

# Get

## Retrieve your user

### Parameters:

| Name           | Optional / Required | Data type | Description                                                                                                                                                                                                                                          | Default                                                                                                                                                                                      |
| -------------- | ------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| return\_fields | optional            | String    | Customize the responses by setting the return fields (id, create\_date, activate\_date, last\_login\_date, username, email, gender, name, firstname, lastname, birth\_date, address, zip\_code, city, country, description, website, blog, language) | id, create\_date, activate\_date, last\_login\_date, username, email, gender, name, firstname, lastname, birth\_date, address, zip\_code, city, country, description, website, blog, languge |

### Demo

&#x20;URL Find your token on - [yumpu.com](https://www.yumpu.com/en/account/profile/api) Token&#x20;

#### Optional parameters:

&#x20;return\_fields&#x20;

Add optional parametersRun request

```
```

{% tabs %}
{% tab title="curl" %}
Example:

```
curl -X GET -H "X-ACCESS-TOKEN: YOUR_ACCESS_TOKEN" "https://api.yumpu.com/2.0/user.json"
```

{% endtab %}

{% tab title="PHP" %}
Example:

```php
require_once('../yumpu.php');
$yumpu = new Yumpu();
$data = array(
    'return_fields' => 'id,create_date,activate_date,last_login_date,username,email,gender,name,firstname,lastname,birth_date,address,zip_code,city,country,description,website,blog,languge'
);
$getUser = $yumpu->getUser($data);
print_r($getUser);
```

{% endtab %}

{% tab title="JavaScript" %}
Example:

```javascript
var yumpu = require('yumpu');
yumpu.setToken('yourToken');
var parameters = {
   return_fields: 'id,create_date,activate_date,last_login_date,username,email,gender,name,firstname,lastname,birth_date,address,zip_code,city,country,description,website,blog,languge'
};
yumpu.getUser(parameters, function(statusCode, document){
   console.log('Status: ' + statusCode);
   console.log(document);
});
```

{% endtab %}

{% tab title="Java" %}
Example:

```java
Yumpu y = new Yumpu("your access token");
String[] params = {"return_fields=id,create_date,activate_date,last_login_date,username,email,gender,name,firstname,lastname,birth_date,address,zip_code,city,country,description,website,blog,languge"};
System.out.println(y.getUser(params));
```

{% endtab %}
{% endtabs %}

Whatever language you are using, the result will be the same.

```bash
{
  "user": {
    "id": "102864144",
    "create_date": "2013-03-08 17:13:43",
    "activate_date": "2013-04-25 14:20:04",
    "username": "Api.User",
    "email": "yumpu.api@gmail.com",
    "gender": "male",
    "name": "Api User",
    "firstname": "Api",
    "lastname": "User",
    "birth_date": "1986-01-01",
    "address": "Moosackerstr. 17",
    "zip_code": "9444",
    "city": "Diepoldsau",
    "country": "CH",
    "description": "I am the API user.",
    "website": "https://www.yumpu.com",
    "blog": "https://blog.yumpu.com",
    "language": "de"
  },
  "state": "success"
}
```
