# Beacon Rest Services V1 (session)

**Canonical:** https://apis.io/apis/beacon-roofing-supply/beacon-rest-v1/  
**Provider:** Beacon Roofing Supply — https://apis.io/providers/beacon-roofing-supply/  
**Base URL:** https://beaconproplus.com/v1/rest/com/becn  
**Documentation:** https://beaconproplus.com/swagger/v1/

Beacon Rest Services V1 (session) is one of 7 APIs that [Beacon Roofing Supply](https://apis.io/providers/beacon-roofing-supply/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Construction, Roofing, Distribution, E-Commerce, and Order. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

The original Beacon PRO+ API surface — login and logout, account switching, branch list, jobs, order history and detail, catalog item lookup, pricing, cart items, order submission and templates. Nineteen published operations. Authenticated with a browser-shaped cookie session (JSESSIONID, DYN_USER_ID, DYN_USER_CONFIRM, siteId) established by POST /login and lasting one hour, or seven days with the RememberMe flag, rather than with a bearer token.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| POST | `/login` | User login with username/password |
| POST | `/logout` | User logout |
| GET | `/getLoginDeclaration` | Get login declaration |
| GET | `/getCurrentUserInfo` | Get current user details |
| GET | `/accounts` | List all available accounts for the user |
| POST | `/switchAccount` | Change user's current account |
| GET | `/branchlist` | List all available branches |
| GET | `/jobs` | List available jobs for an account and provide the job name and number combination rule. |
| GET | `/orderhistory` | List all the orders in the account |
| GET | `/orderdetail` | Get details of the order by Id |
| GET | `/itemlist` | Get list of items |
| GET | `/items` | Get items details |
| GET | `/getProductInfo` | Get product and related accounts info |
| GET | `/getSkuUom` | Get all the Unit of Measure (UoM) for a given sku ids |
| GET | `/pricing` | Get price and Unit of Measures (UoMs) for multiple line items |
| GET | `/cartItems` | Get items in the cart |
| POST | `/submitOrder` | Submit order |
| POST | `/addMultipleItemsToOrder` | Add item(s) to cart |
| GET | `/template` | List all templates and details for the current user |

## Machine-readable artifacts (4)

- **Documentation** — https://beaconproplus.com/swagger/v1/
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/beacon-roofing-supply/refs/heads/main/openapi/beacon-roofing-supply-v1-openapi.yml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/beacon-roofing-supply/refs/heads/main/openapi/beacon-roofing-supply-v1-ng-openapi.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/beacon-roofing-supply/refs/heads/main/overlays/beacon-roofing-supply-v1-overlay.yaml

## Other Beacon Roofing Supply APIs (6)

- [Beacon PRO+ API (V2, OAuth)](https://apis.io/apis/beacon-roofing-supply/beacon-pro-plus/)
- [Beacon External Rest Service (all_api)](https://apis.io/apis/beacon-roofing-supply/beacon-rest-all-api/)
- [Beacon Rest Services V3 (Public / Integrations)](https://apis.io/apis/beacon-roofing-supply/beacon-rest-v3/)
- [Beacon OAuth Rest Service](https://apis.io/apis/beacon-roofing-supply/beacon-oauth/)
- [Beacon Rest Services Public](https://apis.io/apis/beacon-roofing-supply/beacon-rest-public/)
- [Beacon Internal Rest Service](https://apis.io/apis/beacon-roofing-supply/beacon-rest-internal/)

## Tags

Construction, Roofing, Distribution, E-Commerce, Order

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/beacon-roofing-supply/beacon-rest-v1/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/beacon-roofing-supply/.