> ## Documentation Index > Fetch the complete documentation index at: https://docs.tapify.app/llms.txt > Use this file to discover all available pages before exploring further. # Teammitglieder auflisten > Rufe die Mitglieder des Workspaces ab, zu dem dein API-Schlüssel gehört. Liefert Teammitglieder von neu nach alt mit ihren Namen, Anmeldeadressen, Visitenkartenlinks und Einladungsstatus. Die `id` eines Mitglieds ist zugleich seine Profil-ID. Damit kannst du das Mitglied abrufen, aktualisieren oder löschen. Du verwendest sie auch, um einen Kontakt mit `connectedWithProfileId` zuzuweisen. Die separate `accountId` bezeichnet das Konto. Verwende `limit` und `offset`, um mehrere Seiten abzurufen. Jede Antwort enthält bis zu 100 Mitglieder und ein `pagination`-Objekt. Fahre fort, solange `hasMore` den Wert `true` hat. [Beispiel zur Paginierung](https://docs.tapify.app/de/api-reference/requests.md#pagination) ## OpenAPI ````yaml de/api-reference/openapi.json GET /team-members openapi: 3.0.3 info: title: Tapify-API version: 1.0.0 description: >- Lies und verwalte gespeicherte Kontakte, Teammitglieder und ihre digitalen Visitenkarten in einem Tapify-Teams-Workspace. Erfordert Zugriff auf Teams Connect und einen API-Schlüssel für den Workspace. servers: - url: https://tapify.app/api/v1 description: Tapify-API security: - bearerAuth: [] - apiKeyHeader: [] tags: - name: Workspace description: Den mit einem API-Schlüssel verbundenen Workspace prüfen. - name: Teammitglieder description: Mitglieder und ihre digitalen Visitenkarten verwalten. - name: Kontakte description: Im gesamten Workspace erfasste Kontakte verwalten. - name: Zapier description: >- Endpunkte, die die Tapify-Zapier-Integration für Trigger-Beispiele und REST-Hook-Abonnements verwendet. paths: /team-members: get: tags: - Teammitglieder summary: Teammitglieder auflisten description: Gibt Workspace-Mitglieder vom neuesten zum ältesten zurück. operationId: listTeamMembers parameters: - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Offset' responses: '200': description: Eine paginierte Liste der Teammitglieder content: application/json: schema: $ref: '#/components/schemas/TeamMemberListResponse' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/SubscriptionRequired' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: parameters: Limit: name: limit in: query description: >- Maximale Anzahl der Einträge pro Seite. Werte werden auf den Bereich 1–100 begrenzt; bei fehlenden oder ungültigen Zahlen wird 100 verwendet. required: false schema: type: integer minimum: 1 maximum: 100 default: 100 Offset: name: offset in: query description: >- Anzahl der Einträge, die vor dieser Seite übersprungen werden. Negative Werte werden zu 0; bei fehlenden oder ungültigen Zahlen wird 0 verwendet. required: false schema: type: integer minimum: 0 default: 0 schemas: TeamMemberListResponse: type: object required: - data - pagination properties: data: type: array items: $ref: '#/components/schemas/TeamMember' pagination: $ref: '#/components/schemas/Pagination' TeamMember: type: object description: Ein Mitglied des Tapify-Teams-Workspaces. required: - id - workspaceId - accountId - status - firstName - lastName - displayName - email - jobTitle - department - avatarUrl - profileUrl - slug - contact - contactDetails - createdAt - updatedAt properties: id: type: string format: uuid description: >- Teammitglied-ID. Verwende diesen Wert in anderen Endpunkten für Teammitglieder. example: 45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7 workspaceId: type: string format: uuid description: ID des Workspaces, der das Mitglied enthält. example: 9df81bd4-3d76-42cc-9518-a019ea75a221 accountId: type: string format: uuid description: ID des Tapify-Kontos des Mitglieds. example: 0e35f7a8-e866-4f5d-b9cb-06961a130fef status: type: string enum: - not_invited - pending - active - failed description: >- Einladungsstatus: not_invited bedeutet, dass keine Einladung gesendet wurde; pending bedeutet, dass das Mitglied noch nicht aktiviert wurde; active bedeutet, dass das Konto bereit ist; failed bedeutet, dass die Einladung nicht zugestellt werden konnte. example: active firstName: type: string example: Mina lastName: type: string example: Park displayName: type: string description: Vollständiger Name, zusammengesetzt aus firstName und lastName. example: Mina Park email: type: string format: email description: >- Anmelde-E-Mail-Adresse des Mitglieds. Sie ist unabhängig von den email-Einträgen in contactDetails, die auf der Karte veröffentlicht werden. example: mina@acme.com jobTitle: type: string nullable: true example: Head of Partnerships department: type: string nullable: true example: Partnerships avatarUrl: type: string format: uri nullable: true example: https://example.com/mina.jpg profileUrl: type: string format: uri description: Öffentlicher Link zur digitalen Visitenkarte des Mitglieds. example: https://tapify.app/mina-park slug: type: string description: Letzter Teil der URL der digitalen Visitenkarte. example: mina-park contact: type: object description: >- Schnellzugriff auf die jeweils ersten Werte des Mitglieds für Telefon, WhatsApp und Website. required: - phone - whatsapp - website properties: phone: type: string nullable: true example: '+31612345678' whatsapp: type: string nullable: true website: type: string nullable: true example: https://acme.com contactDetails: type: array description: >- In diesem Mitgliederprofil gespeicherte Kontaktdaten. Gemeinsame Unternehmensdaten aus dem Markendesign sind nicht enthalten. items: $ref: '#/components/schemas/TeamMemberContactDetail' createdAt: type: string format: date-time description: Datum und Uhrzeit, zu denen das Mitglied hinzugefügt wurde. example: '2026-07-01T09:30:00.000Z' updatedAt: type: string format: date-time description: Datum und Uhrzeit der letzten Aktualisierung des Mitglieds. example: '2026-07-28T10:15:00.000Z' Pagination: type: object description: Informationen zum Blättern durch eine Ergebnisliste. required: - limit - offset - total - hasMore properties: limit: type: integer description: Maximale Anzahl der angeforderten Einträge. example: 100 offset: type: integer description: >- Anzahl der Einträge, die vor Beginn dieser Seite übersprungen wurden. example: 0 total: type: integer description: Gesamtzahl der passenden Einträge. example: 1 hasMore: type: boolean description: true, wenn eine weitere Seite verfügbar ist. example: false ErrorResponse: type: object description: Informationen zu einer Anfrage, die Tapify nicht abschließen konnte. required: - error properties: error: type: object required: - code - message properties: code: type: string description: Kurzer Code zur Identifizierung des Fehlers. example: bad_request message: type: string description: Verständliche Erklärung des Fehlers. example: Request body is invalid. details: type: object description: >- Zusätzliche Informationen, die beim Korrigieren der Anfrage helfen können. additionalProperties: true nullable: true TeamMemberContactDetail: type: object description: Eine im Mitgliederprofil gespeicherte Kontaktangabe. required: - id - type - label - value properties: id: type: string format: uuid description: ID dieser gespeicherten Kontaktangabe. example: 33d5f285-64f7-41aa-bf9e-17a0fbf535af type: type: string description: Typ der Kontaktangabe. enum: - phone - email - website - address - social_media label: type: string nullable: true description: Auf der digitalen Visitenkarte angezeigte Bezeichnung. example: Mobile value: type: string example: '+31612345678' platform: $ref: '#/components/schemas/SocialPlatform' address: $ref: '#/components/schemas/Address' SocialPlatform: type: string description: Soziale Plattform, auf die dieser Link verweist. enum: - facebook - instagram - linkedin - x - whatsapp - calendly - youtube - pinterest - spotify - tiktok - reddit - behance - bluesky - wechat - discord - dribbble - github - mastodon - medium - messenger - patreon - soundcloud - slack - telegram - snapchat - threads - twitch - yelp Address: type: object description: Eine strukturierte Adresse. Gib mindestens ein nicht leeres Feld an. minProperties: 1 properties: line1: type: string description: Straßenname und Hausnummer. example: Keizersgracht 391 A line2: type: string description: >- Wohnung, Büroeinheit, Stockwerk oder andere zusätzliche Adressangaben. example: '' city: type: string example: Amsterdam postalCode: type: string example: 1016 EJ country: type: string description: Ländercode oder Ländername. example: NL responses: Unauthorized: description: Der API-Schlüssel fehlt, ist falsch oder wurde gelöscht. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_api_key message: API key is invalid or revoked. SubscriptionRequired: description: >- Der Workspace benötigt Zugriff auf Teams Connect. Prüfe seinen Tarif, den Abonnementstatus und den Ablauf der Testphase. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: subscription_required message: Tapify Teams Connect is required for this feature. RateLimited: description: In kurzer Zeit wurden zu viele Anfragen gesendet. headers: Retry-After: description: Wartezeit in Sekunden vor einem erneuten Versuch. schema: type: integer example: 30 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limited message: Rate limit exceeded. details: retryAfter: 30 InternalError: description: Tapify konnte die Anfrage nicht abschließen. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Something went wrong. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Tapify API key description: Unter Einstellungen → API-Schlüssel erstellter API-Schlüssel. apiKeyHeader: type: apiKey in: header name: X-API-Key description: >- Alternative zu Authorization: Bearer. Sende pro Anfrage nur eine Authentifizierungsmethode; ein Bearer-Token hat Vorrang. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.