---
title: "Get all authorisation requests for the last 30 days"
method: GET
path: "/agents/{arn}/invitations"
tags: ["Agents"]
---

# Get all authorisation requests for the last 30 days

`GET /agents/{arn}/invitations`

## Path parameters

- `arn` string, required

## Headers

- `Accept` 'application/vnd.hmrc.2.0+json', required

## Response `200`

A list of authorisation requests

- object[] — Returns all authorisation requests for the last 30 days.
  - `_links` object, required — The link to the invitation
    - `self` object, required — A link to the current resource.
      - `href` string, required
  - `service` union[], required — The service to which this invitation refers
    - union
      - string — MTD IT service
      - string — MTD VAT service
  - `arn` string, required — The Agent Registration Number for the calling agency
  - `created` string, date-time, required — Creation time of the request (RFC3339 / ISO8601 format)
  - `updated` string, date-time — Update time of the request (RFC3339 / ISO8601 format)
  - `expiresOn` string, date — Expiration time of the request (RFC3339 / ISO8601 format)
  - `status` 'Pending' | 'Accepted' | 'Rejected' | 'Cancelled' | 'Deauthorised' | 'Expired' | 'Partialauth', required — The current status of the invitation
  - `clientActionUrl` string, uri — Link for the client to authorise/reject this agent's invitation.
  - `agentType` 'main' | 'supporting', nullable — Only MTD-IT supports this field. Defaults to "main" if omitted.

## Other responses

- `204` — The agent has no authorisation requests in the last 30 days
- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `406` — Not Acceptable
- `500` — Internal Server Error

---

[API](https://skmtc.dev/hmrc/apis/agent-authorisation-api.md) · [All operations](https://skmtc.dev/hmrc/apis/agent-authorisation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hmrc/agent-authorisation-api/revisions/83e8a60b1144/schema)