API v1 Overview

Use v1 to place orders from your own website and let RoofAngle handle the payment gateway. Creating an order returns a Stripe Checkout URL, your customer pays by card there, and the order is confirmed once payment clears. You never handle card details.

If you settle with RoofAngle directly on a billing cycle, use v4 instead.

Base URL: https://sandboxclient-api.roofangle.com

Self-service credentials are sandbox only. Examples throughout these docs use the sandbox host so you can run them with the keys from signup. Production is https://client-api.roofangle.com with separate credentials; email support@roofangle.com when you are ready. Only the base URL and credentials change.

Endpoints

Method	Path	Description
POST	/v1/auth/token	Get an access token
GET	/v1/services	List services with your tenant's pricing
POST	/v1/services/calculate-price	Price a prospective order
GET	/v1/orders	List orders (paged)
GET	/v1/orders/{orderId}	Get one order
GET	/v1/orders/status/{checkoutSessionId}	Look up an order by Stripe session
GET	/v1/orders/by-customer?email=	Orders for a customer email
POST	/v1/orders	Create an order (returns checkoutUrl)
POST	/v1/orders/bulk	Up to 50 orders in one checkout
GET	/v1/orders/{orderId}/files	List an order's files
GET	/v1/files/{fileId}/download	Download one file
GET	/v1/orders/{orderId}/files/download-all	Download all files as ZIP
GET	/v1/files/download?token=	Anonymous download via webhook token
GET	/v1/endpoints	Discover the operations your client may call

What v1 adds over v4

• POST /v1/orders returns a checkoutUrl. Redirect your customer there to pay.
• GET /v1/orders/status/{checkoutSessionId} resolves the order after Stripe redirects back.
• An extra webhook event, order.payment_completed, fires when payment clears.