---
title: "Search for bills that are pending a decision"
method: GET
path: "/v1/web/bill/pending-decision"
tags: ["Bill"]
---

# Search for bills that are pending a decision

`GET /v1/web/bill/pending-decision`

## Query parameters

- `page` integer
- `pageSize` integer
- `orderBy` string

## Response `200`

Default Response

- object
  - `items` object[], required
    - `bill` object, required
      - `id` string, required
      - `externalId` string
      - `status` union, required
        - 'draft'
        - 'submitted'
        - 'returned'
        - 'paymentPending'
        - 'paymentInProgress'
        - 'paid'
        - 'paymentFailed'
        - 'manuallyCompleted'
        - 'deleted'
      - `creatorUserId` string, required
      - `vendorId` string
      - `invoiceId` string
      - `currencyCode` string
      - `invoiceDate` string, date — ISO date string, YYYY-MM-DD
      - `paymentDueDate` string, date — The date that the invoice says the payment is due, in ISO date string, YYYY-MM-DD
      - `totalAmount` string — number string
      - `description` string
      - `lineItems` object[], required
        - `id` string, required
        - `description` string
        - `amount` string, required — Number string
        - `spendCategoryId` string
      - `documents` object[], required
        - `id` string, required
        - `fileName` string, required
        - `type` union, required
          - 'invoice'
          - 'supporting'
        - `status` union, required
          - 'uploading'
          - 'uploaded'
          - 'parsed'
        - `parsedData` object
          - `invoiceId` string, nullable
          - `vendorName` string, nullable
          - `currencyCode` string, nullable
          - `invoiceDate` string, nullable — ISO date string, YYYY-MM-DD
          - `dueDate` string, nullable — ISO date string, YYYY-MM-DD
          - `totalAmount` string, nullable — Decimal string
          - `description` string, nullable
          - `achAccountName` string, nullable
          - `achRoutingNumber` string, nullable
          - `achAccountNumber` string, nullable
          - `lineItems` object[]
            - `description` string, nullable
            - `amount` string, nullable — Decimal string
        - `createdAt` string, date-time, required
        - `accountingIntegration` object
          - `rutterId` string
          - `platformId` string
          - `latestSync` object, required
            - `status` union, required
              - …
            - `createdAt` string, date-time, required
            - `completedAt` string, date-time
            - `error` object
              - …
      - `paymentScheduledDate` string, date — When the payment will be triggered, in ISO date string, YYYY-MM-DD. It should be far enough in advance so when the payment reaches the vendor, it is still before or on the paymentDueDate. Date is based on the payment processor's timezone, i.e. EST.
      - `paymentRoute` union
        - union[] — Flat ordered array of hops the funds will travel through
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - unknown[]
          - unknown
      - `remittanceNotification` object — Notifications when a bill is paid
        - `recipients` object[], required
          - `name` string, required
          - `email` string, required
      - `payment` object
        - `id` string, required — Reference ID for this payment
        - `accountingIntegration` object
          - `rutterId` string
          - `platformId` string
          - `latestSync` object, required
            - `status` union, required
              - …
            - `createdAt` string, date-time, required
            - `completedAt` string, date-time
            - `error` object
              - …
      - `manualCompletion` object — Set when the bill was manually completed
        - `status` union, required
          - 'paid'
          - 'notPaid'
        - `reason` string
      - `purchaseOrder` union
        - object
          - `type` 'manual', required
          - `id` string, required
        - object
          - `type` 'rutter', required
          - `rutterId` string, required
          - `platformId` string, required
      - `accountingIntegration` object
        - `rutterId` string
        - `platformId` string
        - `latestSync` object, required
          - `status` union, required
            - 'inProgress'
            - 'successful'
            - 'failed'
          - `createdAt` string, date-time, required
          - `completedAt` string, date-time
          - `error` object
            - `type` string
            - `code` string
            - `message` string
            - `source` string
            - `platformMessage` string
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `submittedAt` string, date-time
      - `completedAt` string, date-time
    - `approvalRequest` union, required — Approval request, discriminated by `type`
      - object
        - `id` string, required
        - `externalId` string
        - `status` union, required
          - 'draft'
          - 'submitted'
          - 'approved'
          - 'declined'
          - 'returned'
          - 'deleted'
          - 'fulfillmentInProgress'
          - 'fulfilled'
          - 'fulfillmentFailed'
        - `requesterUserId` string, required
        - `deciderUserId` string
        - `deciders` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `observers` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `objectId` string
        - `notes` object[], required
          - `id` string, required
          - `content` string, required
          - `userId` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `submittedAt` string, date-time
        - `decidedAt` string, date-time
        - `fulfilledAt` string, date-time
        - `type` 'createCard', required
        - `request` object, required
          - `name` string, required
          - `frequencyType` union, required
            - 'recurring'
            - 'single'
          - `cardholderId` string, required
          - `userId` string, required
          - `accountId` number, required
          - `cardProfileId` string
          - `cardProfileStrategy` union
            - 'advertising_least_used'
            - 'vertical_optimized'
            - 'shipping_optimized'
            - 'plastiq'
            - 'tokenizable'
          - `expiry` string
          - `categoryIds` string[]
          - `allowedCountries` string[]
          - `spendFrequency` union
            - 'purchase_1d'
            - 'purchase_7d'
            - 'purchase_30d'
            - 'purchase_1y'
            - 'card_debit_lifetime'
          - `spendLimit` number
          - `userGroupId` string
      - object
        - `id` string, required
        - `externalId` string
        - `status` union, required
          - 'draft'
          - 'submitted'
          - 'approved'
          - 'declined'
          - 'returned'
          - 'deleted'
          - 'fulfillmentInProgress'
          - 'fulfilled'
          - 'fulfillmentFailed'
        - `requesterUserId` string, required
        - `deciderUserId` string
        - `deciders` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `observers` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `objectId` string
        - `notes` object[], required
          - `id` string, required
          - `content` string, required
          - `userId` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `submittedAt` string, date-time
        - `decidedAt` string, date-time
        - `fulfilledAt` string, date-time
        - `type` 'payBill', required
        - `request` object, required
      - object
        - `id` string, required
        - `externalId` string
        - `status` union, required
          - 'draft'
          - 'submitted'
          - 'approved'
          - 'declined'
          - 'returned'
          - 'deleted'
          - 'fulfillmentInProgress'
          - 'fulfilled'
          - 'fulfillmentFailed'
        - `requesterUserId` string, required
        - `deciderUserId` string
        - `deciders` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `observers` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `objectId` string
        - `notes` object[], required
          - `id` string, required
          - `content` string, required
          - `userId` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `submittedAt` string, date-time
        - `decidedAt` string, date-time
        - `fulfilledAt` string, date-time
        - `type` 'submitExpense', required
        - `request` object, required
      - object
        - `id` string, required
        - `externalId` string
        - `status` union, required
          - 'draft'
          - 'submitted'
          - 'approved'
          - 'declined'
          - 'returned'
          - 'deleted'
          - 'fulfillmentInProgress'
          - 'fulfilled'
          - 'fulfillmentFailed'
        - `requesterUserId` string, required
        - `deciderUserId` string
        - `deciders` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `observers` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `objectId` string
        - `notes` object[], required
          - `id` string, required
          - `content` string, required
          - `userId` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `submittedAt` string, date-time
        - `decidedAt` string, date-time
        - `fulfilledAt` string, date-time
        - `type` 'createVendor', required
        - `request` object, required
          - `externalId` string
          - `name` string, required
          - `owners` object, required
            - `userIds` string[], required
            - `userGroupIds` string[]
          - `currencyCode` string, required — ISO 4217 currency code
          - `country` string, required
          - `logoUrl` string
          - `spendCategoryId` string
          - `merchantIds` string[]
          - `merchantCategory` string
          - `legalName` string
          - `taxId` object
            - `type` union, required
              - …
            - `id` string, required
          - `address` object
            - `attn` string
            - `line1` string, required
            - `line2` string
            - `city` string, required
            - `zipCode` string, required
            - `state` string, required
            - `country` string, required
          - `rutterId` string, nullable, required — Rutter vendor ID. If null, the vendor will be created in the accounting platform.
          - `contacts` object[], required
            - `type` union
              - …
            - `name` object, required
              - …
            - `default` boolean, required
            - `email` string, required
            - `phone` string
            - `notes` string
      - object
        - `id` string, required
        - `externalId` string
        - `status` union, required
          - 'draft'
          - 'submitted'
          - 'approved'
          - 'declined'
          - 'returned'
          - 'deleted'
          - 'fulfillmentInProgress'
          - 'fulfilled'
          - 'fulfillmentFailed'
        - `requesterUserId` string, required
        - `deciderUserId` string
        - `deciders` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `observers` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `objectId` string
        - `notes` object[], required
          - `id` string, required
          - `content` string, required
          - `userId` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `submittedAt` string, date-time
        - `decidedAt` string, date-time
        - `fulfilledAt` string, date-time
        - `type` 'updateVendor', required
        - `request` object, required
          - `name` string
          - `owners` object
            - `userIds` string[], required
            - `userGroupIds` string[]
          - `currencyCode` string
          - `country` string
          - `status` union
            - 'active'
            - 'disabled'
          - `address` object, nullable
            - `attn` string
            - `line1` string, required
            - `line2` string
            - `city` string, required
            - `zipCode` string, required
            - `state` string, required
            - `country` string, required
          - `taxId` object, nullable
            - `type` union, required
              - …
            - `id` string, required
          - `externalId` string, nullable
          - `legalName` string, nullable
          - `spendCategoryId` string, nullable
          - `logoUrl` string, nullable
          - `merchantCategory` string, nullable
          - `merchantIds` string[], nullable
      - object
        - `id` string, required
        - `externalId` string
        - `status` union, required
          - 'draft'
          - 'submitted'
          - 'approved'
          - 'declined'
          - 'returned'
          - 'deleted'
          - 'fulfillmentInProgress'
          - 'fulfilled'
          - 'fulfillmentFailed'
        - `requesterUserId` string, required
        - `deciderUserId` string
        - `deciders` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `observers` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `objectId` string
        - `notes` object[], required
          - `id` string, required
          - `content` string, required
          - `userId` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `submittedAt` string, date-time
        - `decidedAt` string, date-time
        - `fulfilledAt` string, date-time
        - `type` 'createVendorPaymentMethod', required
        - `request` union, required
          - object
            - `type` 'ach', required
            - `entityType` 'business', required
            - `accountType` union, required
              - …
            - `routingNumber` string, required
            - `accountNumber` string, required
            - `accountName` string, required
            - `accountId` string, required — Dashfi account number (deprecated — will be removed)
          - object
            - `type` 'ach', required
            - `entityType` 'individual', required
            - `accountType` union, required
              - …
            - `routingNumber` string, required
            - `accountNumber` string, required
            - `accountName` string, required
            - `accountHolderName` string, required
            - `accountId` string, required — Dashfi account number (deprecated — will be removed)
      - object
        - `id` string, required
        - `externalId` string
        - `status` union, required
          - 'draft'
          - 'submitted'
          - 'approved'
          - 'declined'
          - 'returned'
          - 'deleted'
          - 'fulfillmentInProgress'
          - 'fulfilled'
          - 'fulfillmentFailed'
        - `requesterUserId` string, required
        - `deciderUserId` string
        - `deciders` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `observers` object, required
          - `userIds` string[]
          - `userGroupIds` string[]
          - `userRoleIds` string[]
          - `userTypes` string[]
        - `objectId` string
        - `notes` object[], required
          - `id` string, required
          - `content` string, required
          - `userId` string, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `submittedAt` string, date-time
        - `decidedAt` string, date-time
        - `fulfilledAt` string, date-time
        - `type` 'deleteVendorPaymentMethod', required
        - `request` object, required
          - `id` string, required
  - `hasNext` boolean, required
  - `totalCount` number, required

## Other responses

- `400` — Default Response
- `401` — The access to this resource has been denied
- `403` — The access to this resource is forbidden
- `default` — Catch-all error response for any unexpected internal errors

---

[API](https://skmtc.net/funneldash/apis/surface-web-api.md) · [All operations](https://skmtc.net/funneldash/apis/surface-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/funneldash/surface-web-api/versions/ac700d65f443/schema)