List Bills

GET

/bills

GET

/v1/bills

curl -G https://api.papertracc.com/v1/bills \
     -H "Authorization: Bearer <apiKey>" \
     -d size=20

{
  "data": [
    {
      "id": "45c6e26d-e132-4548-8e2e-5bfc467cf94a",
      "items": [
        {
          "rate": "50000.00",
          "amount": "500000.00",
          "detail": "Consulting hours",
          "tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
          "quantity": 10,
          "account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
          "inventory_id": "55a40b4d-a23a-49aa-a417-828913e9a5c8",
          "currency_code": "NGN",
          "sku": "SKU-1001"
        }
      ],
      "amount": "250000.00",
      "status": "PENDING",
      "vendor": {
        "id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
        "display_name": "Global Softworks"
      },
      "approval": 0,
      "due_date": "2026-07-18T10:00:00Z",
      "approvals": [],
      "bill_date": "2026-06-18T10:00:00Z",
      "documents": [],
      "account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
      "created_at": "2026-06-18T10:00:00Z",
      "project_id": "spruce-demo",
      "adjustments": [
        {
          "name": "VAT",
          "type": "PERCENTAGE_RATE",
          "value": "7.50",
          "amount": "37500.00",
          "operation": "ADDITION",
          "account_id": "2b0d1461-e52e-4a1a-a69c-11801431c2c9"
        }
      ],
      "payment_schedule": null,
      "prepared_by": "user-token-hash",
      "currency_code": "NGN",
      "exchange_rate": "1.00",
      "bill_reference": "BILL-0001",
      "journal_status": "UNPOSTED"
    }
  ],
  "page": 0,
  "count": 1,
  "pages": 1,
  "status": true,
  "message": "Successfully fetched bills",
  "keyset": null,
  "last_id": null
}

Lists bills.

Requires the can_view_bill permission on the key owner’s role.

Keys: secret key only.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

identitystring

The identity for the active workspace.

Query parameters

sizeintegerOptional

Optional. Number of records to return per page. Defaults to 20, capped at 50.

last_idstringOptional

Optional. The last_id from the previous page’s response. Omit to fetch the first page. Must be sent together with keyset.

keysetstringOptional

Optional. The keyset from the previous page’s response. Must be sent together with last_id.

Response

datalist of objects

pageinteger

countinteger

pagesinteger

statusboolean

messagestring

keysetstring or nullOptional

Send back as keyset, with last_id, to get the next page. null when there are no more records.

last_idstring or nullOptionalformat: "uuid"

Send back as last_id, with keyset, to get the next page. null when there are no more records.

Errors

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error