---
title: "Get a user invitation"
method: GET
path: "/api/v2/user_invitations/{user_invitation_uuid}"
tags: ["Users"]
---

# Get a user invitation

`GET /api/v2/user_invitations/{user_invitation_uuid}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/user_invitations/{user_invitation_uuid}`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `user_access_invite`

Returns a single user invitation by its UUID.

## Path parameters

- `user_invitation_uuid` string, required

## Response `200`

OK

- UserInvitationResponse: User invitation as returned by the API.
  - `data` UserInvitationResponseData: Object of a user invitation returned by the API.
    - `attributes` UserInvitationDataAttributes: Attributes of a user invitation.
      - `created_at` string, date-time: Creation time of the user invitation.
      - `expires_at` string, date-time: Time of invitation expiration.
      - `invite_type` string: Type of invitation.
      - `uuid` string: UUID of the user invitation.
    - `id` string: ID of the user invitation.
    - `relationships` UserInvitationRelationships: Relationships data for user invitation.
      - `user` RelationshipToUser, required: Relationship to user.
        - `data` RelationshipToUserData, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'users', required: Users resource type.
    - `type` 'user_invitations': User invitations type.

## Other responses

- `403`: Authentication error
- `404`: Not found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)