---
title: "Retrieve invitations sent by admin"
method: GET
path: "/api/v1/organisations/invitations"
tags: ["invitation"]
---

# Retrieve invitations sent by admin

`GET /api/v1/organisations/invitations`

## Request

- Base URL: `https://staging.api-golang.boilerplate.hng.tech/api/v1`
- URL: `https://staging.api-golang.boilerplate.hng.tech/api/v1/api/v1/organisations/invitations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger/docs/api/v1/organisations/invitations/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

Request successful

- object
  - `status_code` integer
  - `message` string
  - `data` object[]
    - `email` string
    - `org_id` string
    - `status` string
    - `sent_at` string, date-time
    - `expires_at` string, date-time
    - `invitation_token` string

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger.md) - [All operations](https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger/llms.txt) - [OpenAPI document](https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger/revisions/2d1d3ed96bb9?raw)