> For the complete documentation index, see [llms.txt](https://docs.userlane.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.userlane.com/developer-reference/user-profile-data-export.md).

# User profile data export

Export end-user profile data in JSON format using the API and an authorization token.

## About the user profile data export

This export returns details on Userlane end users in JSON format.

## Requirements

The export requires technical knowledge, so involving a developer is recommended.

## Why use it

Use the data to:

* check that the correct details are stored for each user
* compare Userlane records against statistics collected internally with other tools
* check when a user was activated for Userlane, or when they were last seen

## What is exported

| Field                 | Description                                                                                                                        |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| userlaneId            | A unique ID generated by Userlane                                                                                                  |
| id                    | A unique ID generated and provided by the customer                                                                                 |
| timeCreated           | The time the user was created in Userlane                                                                                          |
| firstSeenAt           | The date and time the user was first detected by Userlane, per application                                                         |
| lastSeenAt            | The date and time the user was last detected by Userlane, per application                                                          |
| applicationAttributes | Custom attributes held for the user on that application, with their values. An unset value shows `null`                            |
| companyAttributes     | Custom attributes held for the user across the company rather than one application, with their values. An unset value shows `null` |

A sample response:

```json
{
  "pagination": {
    "page": 1,
    "limit": 10,
    "totalElements": 1,
    "totalPages": 1
  },
  "users": [
    {
      "id": "<user-provided-id>",
      "userlaneId": "<userlane-db-id>",
      "timeCreated": "2026-03-03 16:40:35",
      "firstSeenAt": "2026-03-03 16:40:35",
      "lastSeenAt": "2026-03-03 16:40:35",
      "applicationAttributes": {
        "key": "value"
      },
      "companyAttributes": {
        "key": "value"
      }
    }
  ]
}
```

## Export the data

### Prerequisites

The export is protected and requires an authorization token. Once the export is enabled on the account, generate the token in the Userlane Portal under **Settings > API Token**. See [Your Userlane API token](/developer-reference/your-userlane-api-token.md).

{% hint style="info" %}
The token is generated per Userlane Manager. A new token can be generated at any time using the same button in the Portal.
{% endhint %}

Run the export from the [developer documentation](https://dev.userlane.com/reference/getapplicationusers-1).

### Prepare the request

Fill out the required fields in the required format. The general view of the export page:

<div data-with-frame="true"><figure><img src="https://259567114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF6bxg8i3T6U4vZ3k7PHi%2Fuploads%2FXAYpqakEiM5kTG1YdJLP%2Fdev%20reference%20user%20profile%20data%20export.png?alt=media&#x26;token=f7ec1d46-f6f4-4321-b5d2-7cf866635600" alt=""><figcaption></figcaption></figure></div>

#### Parameters

To target the data for one application and one time span, enter these search parameters:

* **Application ID:** the Userlane ID of the application
* **lastSeenAfter:** includes only users active after the given time
* **Page and limit:** the maximum is 1,000 elements per page. For a larger result, request each page separately by changing the page number and running the query again

An example of correctly filled parameters:

<div data-with-frame="true"><figure><img src="https://259567114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF6bxg8i3T6U4vZ3k7PHi%2Fuploads%2FiGjUFYyaA7pPfdYK6KqC%2Fdev%20reference%20user%20profile%20data%20export%202.png?alt=media&#x26;token=aaf9a282-aad3-4ccb-8858-b8bc48b9f578" alt=""><figcaption></figcaption></figure></div>

#### Authentication

The request succeeds only with a valid token. Paste it into the authentication field.

<div align="left" data-with-frame="true"><figure><img src="https://259567114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF6bxg8i3T6U4vZ3k7PHi%2Fuploads%2FSiDptD1qgwWMJrTOTKZL%2Fdev%20reference%20user%20profile%20data%20export%203.png?alt=media&#x26;token=c2cd0fa6-3216-487e-a6fe-d7c477077e38" alt=""><figcaption></figcaption></figure></div>

#### Run the request

Once the parameters are set, run the query with the Try it button in the cURL section. The results appear in the response section below.

<figure><img src="https://259567114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF6bxg8i3T6U4vZ3k7PHi%2Fuploads%2F7hwnxxe2M36QXPE95zVI%2Fdev%20reference%20user%20profile%20data%20export%204.png?alt=media&#x26;token=3adb069d-c22e-4c0c-bc51-8c01f96866c2" alt=""><figcaption></figcaption></figure>

Copy the results with the copy icon. The request code can also be copied and used in another tool.

## Troubleshooting

A failed request returns an error message in the result section, which usually identifies the problem. The most common causes are an incorrect date format and an invalid or expired token.

<figure><img src="https://259567114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF6bxg8i3T6U4vZ3k7PHi%2Fuploads%2Fr9xjJcMBjAgRZdLw6GaH%2Fdev%20reference%20user%20profile%20data%20export%205.png?alt=media&#x26;token=bde007ef-2afd-400f-a34c-42c78392d771" alt=""><figcaption></figcaption></figure>

Review the parameters against this article. If the issue persists, contact Userlane.

## Relevant articles

{% content-ref url="/pages/TcXdqgybeGLnS1EODhcN" %}
[Your Userlane API token](/developer-reference/your-userlane-api-token.md)
{% endcontent-ref %}

{% content-ref url="/pages/ZTVMq8E5zKZ7JFbGC4gI" %}
[Push user attributes via API](/developer-reference/push-user-attributes-via-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/gtcOzAVjL7zzv75As2Jd" %}
[Attributes](/administration/attributes.md)
{% endcontent-ref %}

{% content-ref url="/pages/pFJIN3rpdCcXyo6ifg4j" %}
[Export HEART, NPS, Survey, Tag, and Task data via API](/developer-reference/export-heart-nps-survey-tag-and-task-data-via-api.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.userlane.com/developer-reference/user-profile-data-export.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.