---
title: "Get Bills"
method: GET
path: "/v2/bills"
tags: ["Routes", "Bills"]
---

# Get Bills

`GET /v2/bills`

This request gets information such as Bill IDs, Bill Numbers, etc.

This call returns a "meta" object containing URLs that can be used to get data related to the Bill.

Note: this endpoint supports pagination. Please refer to the [**Pagination**](#pagination) section for more information.

Return data description

Property: meta, Description: useful links relating to this Bill
Property: billID, Description: The unique ID of the Bill.
Property: billNumber, Description: The bill number assigned to the Bill.
Property: poID, Description: The poID of which the Bill was made.
Property: locationID, Description: The unique ID of the location associated with this Bill.
Property: date, Description: The date this Bill was created as a UNIX timestamp.
Property: status, Description: The status of this Bill. The status can be as follows: 0: The bill is setup. 1: The bill is submitted. 2: The bill is closed i.e. Marked as Paid
Property: userID, Description: The Id of the user this Bill was assigned to.
Property: userIDStarted, Description: The ID of the user this Bill was created by.
Property: userIDMarkPaid, Description: The ID of the user this Bill was marked paid by.

## Query parameters

- `bills` integer
- `numbers` integer
- `status` string
- `end` integer
- `limit` integer
- `pos` integer
- `start` integer
- `locations` integer
- `cursor` integer
- `page` integer

## Response `200`

Get Bills

- Bill[]
  - `billID` integer
  - `poID` integer
  - `status` integer
  - `userID` integer
  - `userIDStarted` integer
  - `userIDMarkPaid` integer
  - `billNumber` integer
  - `locationID` integer
  - `date` integer
  - `meta` object
    - `items` string
    - `po` string
    - `transactions` string

## Other responses

- `400` — The request was malformed — either invalid JSON syntax or a validation failure (missing required field, wrong type, etc.).
- `401` — No `Authorization` header was provided on the request.
- `403` — The supplied credentials are invalid, the customer account is inactive, or the credentials do not have permission to perform this action.
- `429` — The per-minute or per-hour rate limit for this credential and method has been exhausted. Inspect the `X-RateLimit-*` headers to determine when to retry.
- `500` — An unhandled server-side error. The body message is generic (`System unavailable...`) when the underlying cause is a database fault; otherwise it reflects the raised error.

---

[API](https://skmtc.net/limblecmms/apis/limble-api-v2.md) · [All operations](https://skmtc.net/limblecmms/apis/limble-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limblecmms/limble-api-v2/revisions/eceb9442ed4d/schema)