---
title: "Search for vendors that are pending a decision"
method: GET
path: "/v1/web/vendor/pending-decision"
tags: ["Vendor"]
---

# Search for vendors that are pending a decision

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

* The results do not include `createVendor` requests. 
* Vendor payment methods are returned as reference only; use `GET /vendor/{id}` to resolve those into details.

## Query parameters

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

## Response `200`

Default Response

- object
  - `items` object[], required
    - `vendor` object, required
      - `id` string, required
      - `externalId` string
      - `status` union, required
        - 'active'
        - 'disabled'
        - 'deleted'
      - `name` string, required
      - `owners` object, required
        - `userIds` string[], required
        - `userGroupIds` string[]
      - `currencyCode` 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
      - `country` string, required
      - `logoUrl` string
      - `spendCategoryId` string
      - `merchantIds` string[]
      - `merchantCategory` string
      - `legalName` string
      - `taxId` object
        - `type` union, required
          - 'ssn'
          - 'ein'
        - `id` string, required
      - `address` object
        - `attn` string
        - `line1` string, required
        - `line2` string
        - `city` string, required
        - `zipCode` string, required
        - `state` string, required
        - `country` string, required
      - `contacts` object[], required
        - `id` string, required
        - `type` union
          - 'accountsPayable'
          - 'accountsReceivable'
          - 'it'
          - 'procurement'
          - 'sales'
          - 'support'
          - 'other'
        - `name` object, required
          - `firstName` string, required
          - `middleName` string
          - `lastName` string, required
        - `default` boolean, required
        - `email` string, required
        - `phone` string
        - `notes` string
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `paymentMethods` object[], required
        - `id` string, required
        - `type` 'ach', required
    - `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)