> ## 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.

# Teammitglied abrufen

> Rufe die Daten, den Visitenkartenlink und den Einladungsstatus eines Mitglieds ab.

Verwende die `id` des Mitglieds aus [Teammitglieder auflisten](https://docs.tapify.app/de/api-reference/team-members/list.md) oder [Teammitglied erstellen](https://docs.tapify.app/de/api-reference/team-members/create.md).

Die Antwort enthält Anmeldeadresse, `profileUrl`, Einladungsstatus unter `status` und gespeicherte Kontaktdaten. `contactDetails` enthält die eigenen Visitenkartendaten des Mitglieds. Gemeinsame Unternehmensdaten aus dem Markendesign werden separat verwaltet.

Tapify liefert `404 Not Found`, wenn das Mitglied im Workspace deines API-Schlüssels nicht existiert.


## OpenAPI

````yaml de/api-reference/openapi.json GET /team-members/{memberId}
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/{memberId}:
    parameters:
      - $ref: '#/components/parameters/MemberId'
    get:
      tags:
        - Teammitglieder
      summary: Teammitglied abrufen
      description: >-
        Gibt ein Teammitglied und die Angaben seiner digitalen Visitenkarte
        zurück.
      operationId: getTeamMember
      responses:
        '200':
          description: Informationen zum Teammitglied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TeamMemberResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/SubscriptionRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  parameters:
    MemberId:
      name: memberId
      in: path
      description: Teammitglied-ID.
      required: true
      schema:
        type: string
        format: uuid
        example: 45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7
  schemas:
    TeamMemberResponse:
      type: object
      required:
        - data
      properties:
        data:
          $ref: '#/components/schemas/TeamMember'
    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'
    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.
    NotFound:
      description: Der angeforderte Eintrag ist in diesem Workspace nicht vorhanden.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: not_found
              message: Contact was not found.
    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.