---
title: "GET /v1/invoice/{handle}/event"
method: GET
path: "/v1/invoice/{handle}/event"
tags: ["invoice"]
---

# GET /v1/invoice/{handle}/event

`GET /v1/invoice/{handle}/event`

## Request

- Base URL: `https://customer-portal-api.frisbii.com`
- URL: `https://customer-portal-api.frisbii.com/v1/invoice/{handle}/event`
- Auth: none declared

Get invoice events

## Path parameters

- `handle` string, required

## Query parameters

- `page` integer: Page number to get
- `size` integer: Page size to use (default 20)

## Response `200`

Successful operation

- InvoiceEventList
  - `page` integer, required: Number of current page in paginated list
  - `size` integer, required: Page size in paginated list
  - `count` integer, required: Number of elements in current page
  - `content` InvoiceEvent[], required: List of invoice events
    - `id` string, required: Unique event id assigned by Frisbii
    - `customer` string: Customer handle
    - `subscription` string: Subscription handle
    - `invoice` string: Invoice id
    - `principal` string: Principal id. Only given for principal type user
    - `created` string, date-time, required: When the event happened, in [ISO-8601](http://en.wikipedia.org/wiki/ISO_8601) extended offset date-time format.
    - `event_type` string, required: The event type (see documentation)
    - `principal_type` 'user' | 'api': Principal type `api` or `user`

## Other responses

- `400`: Invalid request, see error codes at https://api.frisbii.com/v1/error_codes
- `401`: None or invalid credentials provided in access to secured resource
- `403`: Not authorized to perform resource operation
- `404`: Resource or referenced resource not found, see error codes at https://api.frisbii.com/v1/error_codes
- `429`: Request limiting exceeded, request rate or concurrent requests, see error code 122 and 123
- `500`: Internal service error, error is reported automatically to Frisbii

---

[API](https://skmtc.dev/frisbii/apis/frisbii-customer-portal-api.md) - [All operations](https://skmtc.dev/frisbii/apis/frisbii-customer-portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/frisbii/apis/frisbii-customer-portal-api/revisions/f0261fb63b1b?raw)