# Gets the invoices.

**GET /v1/Invoices**

Returns a list of invoices. The invoices are returned ordered by the "Timestamp" property and by the boolean value sent in the ascendingOrder parameter. The ascending order might be true or false.


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


## Authentication methods
- Bearer auth


## Parameters
### Headers
- **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.


### Query parameters
- **providerInstanceId** (string(uuid))
  The provider instance id.
- **invoiceType** (string)
  The invoice type. Possible values: onetime, usage, license and dailyratedusage.
- **pageNumber** (integer(int32))
  A cursor for pagination across multiple pages of results. The default value is 1.
- **pageSize** (integer(int32))
  The number of objects to be returned at each page. The size can range between 1 and 2000, and the default is 25.
- **ascendingOrder** (boolean)
  If set to `true` [ascending order].
- **resellerId** (string(uuid))
  The id of a specific reseller. If you are a CSP you can set this to filter by reseller, otherwise don't send a value.
- **customerId** (string(uuid))
  The id of a specific customer. If you are a CSP or a reseller you can set this to filter by customer, otherwise don't send a value.


## Responses
### 200
The request completed with success and returns the invoices.

#### Body: application/json (object)
- **items** (array[object] | null)
  The items for this page.
- **paginationParameters** (object)
  A model that is used to encapsulate the parameters needed to perform pagination queries.
- **totalPages** (integer(int32))
  The total number of pages available for the specified parameters and page size.
- **totalCount** (integer(int32))
  The total number of results available for the specified parameters. Note this is typically not equal to the Count of items in the Items property, will only be equal if all the items fit in the first page.
- **hasPreviousPage** (boolean)
  Indicates if there is a previous page.
- **hasNextPage** (boolean)
  Indicates if there is a next page.
- **continuationToken** (string | null)
  The token to continue to retrieve the paginated items.

### 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.

### 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)