---
reference:
  curl:
    - key: find_invitation_by_token
      id: find_invitation_by_token
      url: /reference/authkit/invitation/find-by-token
      title: '/user_management/invitations/by_token/:token'
      type: GET
      parameters:
        - (invitation.token)
      returns:
        - (invitation)
  js:
    - key: findInvitationByToken
      id: find_invitation_by_token
      url: /reference/authkit/invitation/find-by-token
      title: userManagement.findInvitationByToken()
      parameters:
        - (Invitation.token)
      returns:
        - (Invitation)
  go:
    - key: FindInvitationByToken
      id: find_invitation_by_token
      url: /reference/authkit/invitation/find-by-token
      title: usermanagement.FindInvitationByToken()
      parameters:
        - (ctx)
        - key: opts
          type: usermanagement.FindInvitationByTokenOpts
          unwrap: true
          properties:
            - key: InvitationToken
              type: string
              description: (invitation.token)
      returns:
        - (Invitation)
  php:
    - key: findInvitationByToken
      id: find_invitation_by_token
      url: /reference/authkit/invitation/find-by-token
      title: $userManagement->findInvitationByToken()
      parameters:
        - (Invitation.token)
      returns:
        - (Invitation)
  python:
    - key: find_invitation_by_token
      id: find_invitation_by_token
      url: /reference/authkit/invitation/find-by-token
      title: user_management.find_invitation_by_token()
      parameters:
        - key: invitation_token
          type: str
          description: (invitation.token)
      returns:
        - (Invitation)
  ruby:
    - key: find_invitation_by_token
      id: find_invitation_by_token
      url: /reference/authkit/invitation/find-by-token
      title: UserManagement.find_invitation_by_token()
      parameters:
        - (Invitation.token)
      returns:
        - (Invitation)
  java:
    - key: findInvitationByToken
      id: find_invitation_by_token
      url: /reference/authkit/invitation/find-by-token
      title: userManagement.findInvitationByToken()
      parameters:
        - (Invitation.token)
      returns:
        - (Invitation)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/authkit/invitation/find-by-token.mdx
---

## Find an invitation by token

Retrieve an existing invitation using the token.

<CodeBlock referenceId="find_invitation_by_token">
  <CodeBlockTab title="Request" file="find-invitation-by-token-request" />
  <CodeBlockTab title="Response" file="find-invitation-by-token-response" />
</CodeBlock>