# Gets all the invoice usage line items of an invoice, using pagination.

**GET /v1/Invoices/{id}/usage-lineitems**

Returns a subset of the invoice usage line items of an invoice on each request. Pass the continuation token in the headers to obtain the remaining items.
**Available to the roles:** csp


## Servers
- https://api.cloudcockpit.com: https://api.cloudcockpit.com ()


## Authentication methods
- Bearer auth


## Parameters
### Headers
- **X-ContinuationToken** (string)
  This header should not be set when the first page is desired. For the second page and onwards, pass the continuation token received in the response body.
- **X-Tenant** (string)
  The domain used to access the portal.
- **Authorization** (string)
  JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"
- **X-Correlation-Id** (string(uuid))
  This header is optional and by setting it you can correlate the audit logs made by this request.

### Path parameters
- **id** (string(uuid))
  The id of the invoice.

### Query parameters
- **pageSize** (integer(int32))
  The number of items to be returned at max per page. The size can range between 1 and 2000.


## Responses
### 200
The request completed with success and returns the line items and the continuation token (if applicable).

#### Body: application/json (object)
- **items** (array[object] | null)
  The items in this particular seek operation.
- **continuationToken** (string | null)
  The token to continue to retrieve the paginated items.
  Should not be set if the first page of items is desired.

### 400
There is an error in the parameters sent in the request.

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.

### 401
Please use a valid authorization token.

### 403
You don't have enough permissions to access this information.

### 404
The requested usage invoice does not exist. Any line items previously obtained should be discarded.

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.

### 500
A server error has happened during the request. Please try again later or contact support.

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.


[Powered by Bump.sh](https://bump.sh)