Skip to main content

List Team Invitations

Retrieves all pending invitations for a merchant's team.

Authentication required (User JWT).

GET /api/merchants/:merchantId/team/invitations

Path Parameters​

ParameterTypeDescription
merchantIdStringThe ID of the parent merchant.

Response 200 OK​

Returns an array of pending invitation records.

[
  {
    "id": "uuid-invitation-123",
    "email": "team.member1@example.com",
    "role": "DEVELOPER",
    "status": "PENDING",
    "expiresAt": "2023-11-03T12:00:00.000Z",
    "createdAt": "2023-10-27T12:00:00.000Z",
    "invitedBy": {
      "id": "uuid-user-789",
      "email": "admin@example.com",
      "firstName": "Admin",
      "lastName": "User"
    }
  },
  {
    "id": "uuid-invitation-456",
    "email": "team.member2@example.com",
    "role": "SUPPORT",
    "status": "PENDING",
    "expiresAt": "2023-11-04T15:30:00.000Z",
    "createdAt": "2023-10-28T15:30:00.000Z",
    "invitedBy": {
      "id": "uuid-user-789",
      "email": "admin@example.com",
      "firstName": "Admin",
      "lastName": "User"
    }
  }
]

Errors​

  • 401 Unauthorized: Invalid or missing JWT.
  • 403 Forbidden: User does not have permission to view team invitations.
  • 404 Not Found: Merchant not found.
  • 500 Internal Server Error