---
title: Referral Schnittstelle
description: Du möchtest die wichtigsten API Informationen die wir benötigen wissen? Klicke hier, um mehr zu erfahren.
---

[Zu Content springen](https://help.cleverconnect.com/de/referral-schnittstelle#main-content)

- [Deutsch](https://help.cleverconnect.com/de/referral-schnittstelle)
- [English](https://help.cleverconnect.com/en/knowledgebase/referral-api)

Deutsch

Untermenü für Übersetzungen anzeigen

[Mehr Unterstützung](https://help.cleverconnect.com/de/kb-tickets/new?hsLang=de)

![CC\_Logo\_Colors](https://help.cleverconnect.com/hs-fs/hubfs/CC_Logo_Colors.png?width=200&height=41&name=CC_Logo_Colors.png)

- [Wissensdatenbank Home](https://help.cleverconnect.com/de/)
- Produkt
  
  Untermenü für Produkt anzeigen

    - [Empfehlungen & Interne Mobilität](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t)
    - [Talentplattform](https://help.cleverconnect.com/de/candidate-relationship-management)
    - [Video Interview - Personalvermittler](https://help.cleverconnect.com/de/videointerview-personalvermittler)
    - [Video Interview - Kandidat](https://help.cleverconnect.com/de/videointerview-kandidat)
    - [Integration](https://help.cleverconnect.com/de/integration)
    - [Plattform](https://help.cleverconnect.com/de/plattform)
- [Support Portal](https://portal.cleverconnect.com/tickets-view)
- [Ausloggen](https://portal.cleverconnect.com/_hcms/mem/logout)

Hauptnavigation öffnen

Hauptnavigation schließen

- [Wissensdatenbank Home](https://help.cleverconnect.com/de/)
- Produkt
  
  Untermenü für Produkt anzeigen

    - [Empfehlungen & Interne Mobilität](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t)
    - [Talentplattform](https://help.cleverconnect.com/de/candidate-relationship-management)
    - [Video Interview - Personalvermittler](https://help.cleverconnect.com/de/videointerview-personalvermittler)
    - [Video Interview - Kandidat](https://help.cleverconnect.com/de/videointerview-kandidat)
    - [Integration](https://help.cleverconnect.com/de/integration)
    - [Plattform](https://help.cleverconnect.com/de/plattform)
- [Support Portal](https://portal.cleverconnect.com/tickets-view)
- [Ausloggen](https://portal.cleverconnect.com/_hcms/mem/logout)
- - [Deutsch](https://help.cleverconnect.com/de/referral-schnittstelle)
    - [English](https://help.cleverconnect.com/en/knowledgebase/referral-api)

  Deutsch
  
  Untermenü für Übersetzungen anzeigen
- [Mehr Unterstützung](https://help.cleverconnect.com/de/kb-tickets/new)
- [Ticket erstellen](https://portal.cleverconnect.com/tickets-view/new?)

[Ticket erstellen](https://portal.cleverconnect.com/tickets-view/new?hsLang=de)

 Wie können wir Ihnen helfen?

- Es gibt keine Vorschläge, da das Suchfeld leer ist.

1. [Cleverconnect CXP](https://help.cleverconnect.com/de?hsLang=de)
2. [Integration](https://help.cleverconnect.com/de/integration?hsLang=de)

# Referral Schnittstelle

*Wichtiger Hinweis: Nicht alle unsere Endpunkte sind hier dokumentiert. Bitte kontaktieren Sie uns, um eine ausführliche Dokumentation zu erhalten.*

### Authentifizierung

Für eine erfolgreiche Authentifizierung müssen folgende Header gesetzt werden:

```
User-Source: this data will be communicated separatelyX-Token: <Token> 
```

#### Gamification-Punkte abrufen (Empfehlungsprogramm)

Mit dieser Methode können Sie alle Punkte abrufen, die allen Mitarbeitern in einem bestimmten Zeitraum gutgeschrieben wurden.

### Call

 GET 

https://api.talentry.com/api/v1/tenants/\<tenantId\>/gamificationPointsReport/\<startDate\>/\<endDate\> 

Das Datumsformat ist JJJJ-MM-TT. Die Uhrzeit wird als 00:00:00 Uhr für den Start und 23:59:59 Uhr für das Ende angenommen.

 

### Response

```
[   {      "id": "q038tay42u0shux45tzdn8",      "externalId": "21023",      "email": "thomas.test@university.gov",      "points": "235"   },   {      "id": "zml0lllhetn7ir3a77v28n",      "externalId": "8976",      "email": "sanchez.test@university.gov",      "points": "180"   }] 
```

- id (string) CleverConnects Mitarbeiter-ID
- externalId (string oder null) ID des Mitarbeiters aus dem Kundensystem
- email (string) E-Mail-Adresse des Mitarbeiters
- points (integer) Gesamtpunktzahl des Mitarbeiters innerhalb des Zeitraums

#### Einstellungsprämien

Mit dieser Methode können Sie Bewerbungen und zugehörige Informationen zu Einstellungsprämien basierend auf der letzten Phasenänderung abrufen. Datum

### Call

GET 

https://api.talentry.com/api/v1/tenants/\<customerId\>/applications/\<stageExternalId\>/\<startDate\>/\<endDate\> 

Das Datumsformat ist JJJJ-MM-TT. Die Uhrzeit wird als 00:00:00 Uhr für den Start und 23:59:59 Uhr für das Ende angenommen.

### Response

```
{[    {       "applicationId": "0w1qydbqoxb249t883vpwa",       "applicationExternalId": null,       "applicationStageId": "hired",       "applicationLastStageChangeDate": "2023-06-21T11:45:01+0000",       "jobId": "2703",       "jobExternalId": null,       "talentFirstName": "First",       "talentLastName": "Last",       "talentEmail": "first.last@example.invalid",       "rewardTypeExternalId": "EUR",       "rewardAmount": 10,       "referrerEmployeeId": 1876,       "referrerExternalId": null,       "referrerStaffId" : "ABCDEF123456",      "referrerFirstName": "First",       "referrerLastName": "Referrer",       "referrerEmail": "first.referrer@example.invalid",       "referrerCompanyExternalId": "5",       "referrerDepartmentExternalId": "14",       "referrerLocationExternalId": "12"    } ] } 
```

- [Karriereseite](https://help.cleverconnect.com/de/karriereseite?hsLang=de#main-content)

    - [Allgemein & Einrichtung](https://help.cleverconnect.com/de/karriereseite?hsLang=de#allgemein-einrichtung)
    - [Standortverwaltung](https://help.cleverconnect.com/de/karriereseite?hsLang=de#standortverwaltung)
    - [Design & Branding](https://help.cleverconnect.com/de/karriereseite?hsLang=de#design-branding)
- [Empfehlungen & interne Mobilität](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#main-content)

    - [Allgemeines & Einrichtung](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#allgemeines-einrichtung)
    - [Nutzer](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#nutzer)
    - [Gamifizierung](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#gamifizierung)
    - [Stories](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#stories)
    - [Bewerbungen](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#bewerbungen)
    - [Recruiter](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#recruiter)
    - [Reports](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#reports)
    - [Best Practices](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#best-practices)
    - [Kommunikation](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#kommunikation)
    - [Datenschutz](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#datenschutz)
    - [Empfehlung](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#empfehlung)
    - [Kampagne](https://help.cleverconnect.com/de/empfehlungen-interne-mobilit%C3%A4t?hsLang=de#kampagne)
- [Candidate Relationship Management](https://help.cleverconnect.com/de/candidate-relationship-management?hsLang=de#main-content)

    - [Talente](https://help.cleverconnect.com/de/candidate-relationship-management?hsLang=de#talente)
    - [Talentfelder](https://help.cleverconnect.com/de/candidate-relationship-management?hsLang=de#talentfelder)
    - [Allgemeines](https://help.cleverconnect.com/de/candidate-relationship-management?hsLang=de#allgemeines)
    - [Automatisierungen](https://help.cleverconnect.com/de/candidate-relationship-management?hsLang=de#automatisierungen)
    - [Kampagnen](https://help.cleverconnect.com/de/candidate-relationship-management?hsLang=de#kampagnen)
    - [Pools](https://help.cleverconnect.com/de/candidate-relationship-management?hsLang=de#pools)
- [Videointerview - Personalvermittler](https://help.cleverconnect.com/de/videointerview-personalvermittler?hsLang=de#main-content)

    - [Schritt für Schritt Anleitung](https://help.cleverconnect.com/de/videointerview-personalvermittler?hsLang=de#schritt-f%C3%BCr-schritt-anleitung)
    - [Mein Account](https://help.cleverconnect.com/de/videointerview-personalvermittler?hsLang=de#mein-account)
    - [Einladung & Teilen](https://help.cleverconnect.com/de/videointerview-personalvermittler?hsLang=de#einladung-teilen)
    - [Kampagne](https://help.cleverconnect.com/de/videointerview-personalvermittler?hsLang=de#kampagne)
- [Videointerview – Kandidat](https://help.cleverconnect.com/de/videointerview-kandidat?hsLang=de#main-content)

    - [Nützliche Informationen](https://help.cleverconnect.com/de/videointerview-kandidat?hsLang=de#n%C3%BCtzliche-informationen)
- [Integration](https://help.cleverconnect.com/de/integration?hsLang=de)
- [Plattform](https://help.cleverconnect.com/de/plattform?hsLang=de#main-content)

    - [Tickets](https://help.cleverconnect.com/de/plattform?hsLang=de#tickets)

[![CC\_Logo\_Colors (1)](https://help.cleverconnect.com/hs-fs/hubfs/CC_Logo_Colors%20(1).png?width=200&height=41&name=CC_Logo_Colors%20(1).png "CC_Logo_Colors (1)")](http://cleverconnect.com)

© Copyright 2025 | CleverConnect. All rights reserved. | [Legal notice](https://www.cleverconnect.com/legal-notice) | [Privacy policy](https://www.cleverconnect.com/privacy-policy) |<https://www.cleverconnect.com/privacy-policy>

<https://www.youtube.com/@CleverConnect> <https://www.instagram.com/_cleverconnect/> <https://www.linkedin.com/company/cleverconnect/posts/?feedView=all> [mailto:contact@cleverconnect.com](mailto:contact@cleverconnect.com)