# Turn HD Supply into an API

> Build methods that return your HD Supply Order History & Status, your Active Quotes and the orders waiting for an Approver as JSON. A workflow can email you each weekday morning the orders still waiting, before they expire on day 5.

Page: https://fous.com/automate/hd-supply
Updated: 2026-11-12

Works with your own HD Supply account. Fous is an independent product.

## What you can build on HD Supply

### Get order history

Reads Order History & Status for your account, phone and online orders alike, with each order's PO number, purchaser, status and ship-to.

- Takes: Placed since, tab (Open Orders, Cancelled Orders or All Orders), PO number (optional)
- Returns: Order number, PO number, total charge, placed on, purchaser, status, shipped to

### List active quotes

Reads the Quote List page for your Active Quotes, with the time left on each quote's 10-day price lock.

- Takes: Nothing
- Returns: Quote name or number, created date, items, quote total, days left on the price lock

### Get orders awaiting approval

Reads the orders in Digital Order Workflow that are at or above your Order Threshold and still waiting for an Approver's review.

- Takes: Account (optional)
- Returns: Order number, account, purchaser, placed on, order total, status

### Approve or reject an order

Opens one order waiting in Digital Order Workflow and approves or rejects it, as the signed-in Approver.

- Takes: Order number, approve or reject, comment (optional)
- Returns: Order number, decision, status after review, reviewed at

## Automate HD Supply with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Orders awaiting approval, before they expire

Starts: Every weekday at 8:00

1. Get the orders waiting for an Approver in Digital Order Workflow.
2. Keep the orders placed 3 or more days ago, which expire on day 5.
3. Email you the list with purchaser, order total and placed on date.

### Last week's orders, posted to accounting

Starts: Every Monday at 7:00

1. Get Order History & Status for orders placed in the last 7 days.
2. Keep the orders not in last Monday's run.
3. Post each order's number, PO number, purchaser, total charge and ship-to to your accounting system's webhook.

### Quotes near the end of their price lock

Starts: Every weekday at 7:30

1. List the Active Quotes on the Quote List page.
2. Keep the quotes with 2 days or less left on the 10-day price lock.
3. Email you each one with its items and quote total.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get order history” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "hdsupplysolutions.com/get_order_history",
    "input": {
      "placed_since": "2026-11-02",
      "tab": "All Orders"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "orders": [
      {
        "order_number": "S-48211936",
        "po_number": "MAINT-1107",
        "total_charge": 642.18,
        "placed_on": "2026-11-10",
        "purchaser": "Maintenance Supervisor, Acme Apartments",
        "status": "Shipped",
        "shipped_to": "Acme Apartments, 1200 Oak St, Atlanta, GA"
      }
    ],
    "count": 1,
    "currency": "USD"
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## HD Supply’s own options

HD Supply has no public API for customers. It connects buyers' e-procurement systems through punch-outs and its Punch-In flow, arranged with its e-Procurement Solutions team, and sends invoices in formats including EDI and cXML, set up with your IT team. Invoices and statements are also on Invoice Gateway, and purchase history reports come from customer care on request.

| Option | What it covers | What it takes |
| --- | --- | --- |
| e-Procurement: punch-out and Punch-In | Shopping HD Supply's catalog from your e-procurement system, with the cart sent back to that system for approval | Opting your accounts in and a supported e-procurement system, arranged with HD Supply's e-Procurement Solutions team |
| Custom electronic invoicing (EDI, cXML) | Invoice data in formats including EDI and cXML | Set up with your IT team |
| Invoice Gateway and Product Purchase Reports | Invoices and statements with proof of delivery from the last 24 months, and reports of your purchasing history | Free; enrollment token from an invoice or statement; reports requested from customer care |
| HDSupplySolutions.com by hand | Order History & Status, Quotes and Digital Order Workflow | A username and password for your account |

Read on November 12, 2026: [HD Supply e-Procurement](https://hdsupplysolutions.com/s/ebusiness_solutions), [HD Supply Electronic Invoicing](https://hdsupplysolutions.com/s/electronic_invoicing), [HD Supply Invoice Gateway](https://hdsupplysolutions.com/s/invoice_gateway).

## Signing in to HD Supply

You sign in to HDSupplySolutions.com with a username and password, and in Digital Order Workflow roles such as Buyer, Web Administrator and Buyer/Approver decide who places and who approves orders. With Fous you sign in once through that same sign-in with your own account, and when the session expires Fous signs back in.

## Worth knowing

- **Order history covers 12 months**: Order History shows the orders placed from your account in the last 12 months, over the phone and online alike. Keep your own copy if you need older orders.
- **Pending orders expire after 5 days**: An order at or above the Order Threshold waits for an Approver. A reminder goes out after 3 days and the order expires after 5 days.
- **Workflow is set up per account**: Each account has one Order Threshold for all users, and each account needs its own workflow setup. Order Workflow applies only to orders placed on the website.
- **Invoices live in Invoice Gateway**: Invoices and statements are in Invoice Gateway, a separate sign-in reached from Invoices in the header, not in Order History. Its default delivery is an email notice without the PDF.

## More in Trades, field service and facilities

- [Travis Perkins](https://fous.com/automate/travis-perkins.md)
- [GreenSky merchant portal](https://fous.com/automate/greensky-merchant-portal.md)
- [CorrigoPro](https://fous.com/automate/corrigopro.md)
- [Housecall Pro](https://fous.com/automate/housecall-pro.md)
- [Gas Safe Register online services](https://fous.com/automate/gas-safe-register-online-services.md)
- [Frontdoor Contractor Portal](https://fous.com/automate/frontdoor-contractor-portal.md)
- [LennoxPros](https://fous.com/automate/lennoxpros.md)
- [Carrier Enterprise](https://fous.com/automate/carrier-enterprise.md)
- [Johnstone Supply](https://fous.com/automate/johnstone-supply.md)
- [PowerClerk](https://fous.com/automate/powerclerk.md)
- [Angi Pro](https://fous.com/automate/angi-pro.md)
- [Thumbtack Pro](https://fous.com/automate/thumbtack-pro.md)
- [Checkatrade](https://fous.com/automate/checkatrade.md)
- [Ferguson](https://fous.com/automate/ferguson.md)
- [Reece maX](https://fous.com/automate/reece-max.md)
- [XactAnalysis](https://fous.com/automate/xactanalysis.md)
- [SRS Roof Hub](https://fous.com/automate/srs-roof-hub.md)
- [GC ONLINE PLUS](https://fous.com/automate/gc-online-plus.md)
- [Enphase Installer Platform](https://fous.com/automate/enphase-installer-platform.md)
- [Bunnings PowerPass](https://fous.com/automate/bunnings-powerpass.md)

Other industries: [Avetta](/automate/avetta), [TallyPrime](/automate/tallyprime), [Mindbody](/automate/mindbody), [Decisiv SRM](/automate/decisiv-srm), [Ally Dash](/automate/ally-dash), [Indeed for Employers](/automate/indeed-for-employers).

## Frequently asked questions

### Does HD Supply have an API?

No public customer API. HD Supply offers punch-out and Punch-In connections to e-procurement systems, arranged with its e-Procurement Solutions team, and invoices in formats including EDI and cXML. Order History, Quotes and order approvals are otherwise used on HDSupplySolutions.com.

### Can I get orders placed over the phone, not just online?

Yes. Order History & Status shows all orders placed on your account, by phone or online, so a method that reads it returns both, for the last 12 months.

### Who can approve orders through a method?

Only an Approver. A method reads and does only what the signed-in account can, and in Digital Order Workflow only Approvers review orders at or above the Order Threshold.

### Can I export my purchase history?

HD Supply sends Product Purchase Reports for 12 months, year to date or other date ranges when you ask customer care. A method that reads Order History & Status gives you the order list as JSON whenever you call it.

### Is Fous affiliated with HD Supply?

No. Fous is an independent product. It works through your own HD Supply account and sees only what that account can see.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of HD Supply (HD Supply). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.