How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Beacon Internal Rest Service

An internal-facing Beacon service that is nonetheless listed on the same public Swagger index and whose documentation is served without authentication — user and internal-user administration, EagleView report reconciliation, invoice access and account tooling. Twenty-one operations secured with an internalAuth bearer scheme. Catalogued here because Beacon publishes it publicly, not because it is offered as a partner surface.

Beacon Internal Rest Service is one of 7 APIs that Beacon Roofing Supply publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Construction, Distribution, Administration, Internal, and Roofing. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

This API exposes 21 operations across 21 paths, organized into 9 resource areas, and defines 29 schemas. It is described by OpenAPI 3.0.0, at version 24PI-4-Sprint-3.

Requests are made against a single base URL, https://beaconproplus.com/v2/rest/com/becn.

21 operations 21 paths 29 schemas 2 GET19 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
24PI-4-Sprint-3
Base URL
https://beaconproplus.com/v2/rest/com/becn
Authentication
HTTP Bearer
Resource Areas
9

Authentication & Security 1

Beacon Internal Rest Service declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (token) (internalAuth).

Paths & Operations 21

Across 21 paths, the API surfaces 21 operations — 2 GET, 19 POST. They span 9 resource areas: IDP Token Services, Pricing Services, My Account Services, Customer Services, Invoiced Services, Eagle View Order, Journal Services, Sales Order Hold Services, Eagle View Reports. Each is listed below with its method, path, parameters, and response codes.

IDP Token Services 1
POST
/auth/realms/master/protocol/openid-connect/token
obtain IDP Tokens
5 params → 200400401405500
Pricing Services 2
POST
/orderPricing
query order price
body → 200400401405500
POST
/quotePricing
query quote price
body → 200400401405500
My Account Services 2
POST
/deleteUser
delete BPP user from database.
body → 200400401405500
POST
/deleteInternalUser
delete BCC user from database.
body → 200400401405500
Customer Services 4
POST
/createdCustomerAccount
submit customer data to mincron service
body → 200400401405500
POST
/createdCustomerJob
submit customer data to mincron service
body → 200400401405500
POST
/createdCACustomerAccount
submit customer data to mincron service
body → 200400401405500
POST
/createdCACustomerJob
submit customer data to mincron service
body → 200400401405500
Invoiced Services 1
GET
/invoice
List invoiced Data under the account
11 params → 200400401403405419500
Eagle View Order 1
POST
/saveEagleViewOrderBilling
Store EV order bill data
body → 200401405500
Journal Services 5
POST
/validateJournal (Deprecated)
submit validation journal service to mincron service
body → 200400401405500
POST
/createJournal (Deprecated)
create journal data to mincron service
body → 200400401405500
POST
/validateCAJournal (Deprecated)
submit validation journal service to mincron service
body → 200400401405500
POST
/createCAJournal (Deprecated)
create journal data to mincron service
body → 200400401405500
POST
/operateJournal
journal operation to mincron service
body → 200400401405500
Sales Order Hold Services 2
POST
/createSalesOrderHold
create inbound sales order hold data to mincron service
body → 200400401405500
POST
/createCASalesOrderHold
create inbound sales order hold data to mincron service
body → 200400401405500
Eagle View Reports 3
POST
/eagleview/updateReportsByIds
Get reports from eagle view, reportIds is required, the report Id list, separated by comma, e.g. "57049005,57058363"
body → 200400401405500
POST
/eagleview/updateReportsByDate
Get reports from eagle view, fromDate/toDate is required.
body → 200400401405500
GET
/eagleview/OrderStatusUpdate
Update order status
4 params → 200400401405500

Schemas 29

The contract defines 29 schemas that model the data the API accepts and returns. The most detailed are salesOrderHold (14 properties), itemPrice (13 properties), orderInvoice (12 properties), IDPTokenResp (8 properties). Each schema is shown below with its type and property counts.

priceRequest
object
4 properties 3 required
quotePriceRequest
object
5 properties 3 required
pricingItem
object
3 properties 1 required
itemPrice
object
13 properties
IDPTokenResp
object
8 properties
createCustomerResp
object
3 properties
journalResp
object
3 properties
createSalesOrderResp
object
3 properties
itemPricingResp
object
1 property
deleteUserReq
object
2 properties
deleteInternalUserReq
object
1 property
createCustomerJobReq
object
1 property
createCustomerReq
object
1 property
journalValidateReq
object
2 properties
journalCreateReq
object
2 properties
journalReq
object
2 properties
createSalesOrderHoldReq
object
1 property
salesOrderHoldData
object
1 property
salesOrderHold
object
14 properties
orderInvoiceRep
object
2 properties
orderInvoice
object
12 properties
BCPaginationDataObj
object
6 properties
BCOtherPaginationObj
object
3 properties
BCPaginationObj
object
4 properties
saveEagleViewOrderBilling_req
object
7 properties
saveEagleViewOrderBilling_res
object
3 properties
eagleViewReportUpdateByDateRequest
object
3 properties
eagleViewReportUpdateRequest
object
2 properties
eagleViewReportCommonResponse
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

beacon-roofing-supply-internal-openapi.yml Raw ↑

Other APIs Beacon Roofing Supply publishes across the network.

Beacon PRO+ API (V2, OAuth)
Beacon External Rest Service (all_api)
Beacon Rest Services V3 (Public / Integrations)
Beacon Rest Services V1 (session)
Beacon OAuth Rest Service
Beacon Rest Services Public
Where this information came from

This is an independent, third-party profile of Beacon Internal Rest Service, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.