---
title: Retrieving Employee data
description: In this article, you will discover how to retrieve employees data in Gamfi application using API.
---

[Skip to content](https://gamfi.support/help/retrieving-employee-data#main-content)

- [English](https://gamfi.support/help/retrieving-employee-data)
- [Polski](https://gamfi.support/pl/help/pobieranie-danych-dot.-użytkowników)

English

Show submenu for translations

[Customer portal](https://gamfi.support/tickets?hsLang=en)

![Logo-gamfi\_orange.png\]](https://gamfi.support/hs-fs/hubfs/Logo-gamfi_orange.png?height=40&name=Logo-gamfi_orange.png)

- [Knowledge base](https://gamfi.support/help)

Open main navigation

Close main navigation

- [Knowledge base](https://gamfi.support/help)
- - [English](https://gamfi.support/help/retrieving-employee-data)
    - [Polski](https://gamfi.support/pl/help/pobieranie-danych-dot.-użytkowników)

  English
  
  Show submenu for translations
- [Customer portal](https://gamfi.support/tickets)
- [Go to gamfi.com](https://gamfi.com/)

[Go to gamfi.com](https://gamfi.com/)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Knowledge base](https://gamfi.support/help?hsLang=en)
2. [Gamfi API Docs](https://gamfi.support/help/gamfi-api-docs?hsLang=en)
3. [People management](https://gamfi.support/help/gamfi-api-docs?hsLang=en#people-management)

# Retrieving Employee data

## In this article, you will discover how to retrieve employees data in Gamfi application using API.

Downloading employee data is possible in three ways, using:

- ID
- e-mail
- phone number

#### ID

To retrieve an employee's data using their ID use the method and endpoint:

`GET` + `/api/workflows/admin/integration/user/{ID}`

Example cURL:

```
curl --location 'https://{app_name}.gamfi.io/api/workflows/admin/integration/user/2' \--header 'X-Samus-Authorization-Api-Key: {apiKey}' \--header 'X-Samus-Authorization-Api-Secret: {apiSecret}'
```

In place:

- **{app\_name}** - insert the name of your application
- **{ID}** - insert the employee's ID from the Gamfi application
- **{apiKey}** - insert API key
- **{apiSecret}** - insert API secret

#### E-mail

To retrieve an employee's data using their email use the method and endpoint:

`GET` + `/api/workflows/admin/integration/user/email/{email}`

Example cURL:

```
curl --location 'https://{app_name}.gamfi.io/api/workflows/admin/integration/user/email/john.doe@gamfi.com' \--header 'X-Samus-Authorization-Api-Key: {apiKey}' \--header 'X-Samus-Authorization-Api-Secret: {apiSecret}'
```

In place:

- **{app\_name}** - insert the name of your application
- **{email}** - insert the user's email from the Gamfi application
- **{apiKey}** - insert API key
- **{apiSecret}** - insert API secret

#### Numer telefonu

To retrieve an employee's data using their phone number use the method and endpoint:

`GET` + `/api/workflows/admin/integration/user/phone/{phone_number}`

Example cURL:

```
curl --location 'https://{app_name}.gamfi.io/api/workflows/admin/integration/user/phone/123456789' \--header 'X-Samus-Authorization-Api-Key: {apiKey}' \--header 'X-Samus-Authorization-Api-Secret: {apiSecret}'
```

In place:

- **{app\_name}** - insert the name of your application
- **{phone\_number}** - insert the employee's phone number from the Gamfi application
- **{apiKey}** - insert API key
- **{apiSecret}** - insert API secret

If the response is correct (200), you will receive a confirmation:

```
{    "id": 2,    "forename": "Administrator",    "surname": "Gamfi",    "avatar": null,    "email": "admin@gamfi.pl",    "phone": null,    "locations": [],    "categories": [],    "custom_fields": []}
```

 

- [Getting started](https://gamfi.support/help/getting-started?hsLang=en#main-content)

    - [Get to know the Gamfi app](https://gamfi.support/help/getting-started?hsLang=en#get-to-know-the-gamfi-app)
    - [User portal](https://gamfi.support/help/getting-started?hsLang=en#user-portal)
    - [Admin panel](https://gamfi.support/help/getting-started?hsLang=en#admin-panel)
    - [Basic technical requirements](https://gamfi.support/help/getting-started?hsLang=en#basic-technical-requirements)
- [Set a standard - create a Workflow](https://gamfi.support/help/set-a-standard-create-a-workflow?hsLang=en#main-content)

    - [Workflow - Process template](https://gamfi.support/help/set-a-standard-create-a-workflow?hsLang=en#workflow-process-template)
    - [Actions - the "puzzles" that make up the Workflow](https://gamfi.support/help/set-a-standard-create-a-workflow?hsLang=en#actions-the-puzzles-that-make-up-the-workflow)
    - [Locations and Categories - match Workflow to employee type](https://gamfi.support/help/set-a-standard-create-a-workflow?hsLang=en#locations-and-categories-match-workflow-to-employee-type)
    - [Knowledge base - create a document database](https://gamfi.support/help/set-a-standard-create-a-workflow?hsLang=en#knowledge-base-create-a-document-database)
    - [User segment](https://gamfi.support/help/set-a-standard-create-a-workflow?hsLang=en#user-segment)
- [Automatise and scale Processes](https://gamfi.support/help/automatise-and-scale-processes?hsLang=en#main-content)

    - [Run the Process - release the Actions scheduled in Workflow](https://gamfi.support/help/automatise-and-scale-processes?hsLang=en#run-the-process-release-the-actions-scheduled-in-workflow)
    - [Manage Processes](https://gamfi.support/help/automatise-and-scale-processes?hsLang=en#manage-processes)
    - [Use Roles - involve other actors in the Process](https://gamfi.support/help/automatise-and-scale-processes?hsLang=en#use-roles-involve-other-actors-in-the-process)
- [Education, Engagement and Communication](https://gamfi.support/help/education-engagement-and-communication?hsLang=en)
- [Reports](https://gamfi.support/help/reports?hsLang=en#main-content)

    - [Reports in Admin Panel](https://gamfi.support/help/reports?hsLang=en#reports-in-admin-panel)
    - [Reports in User Portal](https://gamfi.support/help/reports?hsLang=en#reports-in-user-portal)
- [Gamfi API Docs](https://gamfi.support/help/gamfi-api-docs?hsLang=en#main-content)

    - [People management](https://gamfi.support/help/gamfi-api-docs?hsLang=en#people-management)
    - [Process and workflow management](https://gamfi.support/help/gamfi-api-docs?hsLang=en#process-and-workflow-management)
    - [Downloading reports](https://gamfi.support/help/gamfi-api-docs?hsLang=en#downloading-reports)

- [Knowledge base](https://gamfi.support/help)

[![Chill listening crop-3](https://gamfi.support/hs-fs/hubfs/Logo-gamfi_orange-1.png?width=82&height=24&name=Logo-gamfi_orange-1.png "Chill listening crop-3")](http://gamfi.com)

<https://www.facebook.com/Gamfi> <https://www.linkedin.com/company/gamfi> <https://www.instagram.com/wearegamfi/>

Copyright © 2025, Gamfi