API v4 Overview
Use v4 when you settle with RoofAngle directly. Orders are placed immediately with no per-order card checkout, and the balance is invoiced on your agreed billing cycle. Collecting payment from your own customer, if you do, is yours to handle.
If you would rather RoofAngle collected the card payment per order, use v1 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 | /v4/auth/token | Get an access token |
GET | /v4/services | List services with your tenant's pricing |
POST | /v4/services/calculate-price | Price a prospective order |
GET | /v4/orders | List orders (paged) |
GET | /v4/orders/{orderId} | Get one order |
GET | /v4/orders/by-customer?email= | Orders for a customer email |
POST | /v4/orders | Create an order |
POST | /v4/orders/bulk | Create up to 50 orders in one call |
GET | /v4/orders/{orderId}/files | List an order's files |
GET | /v4/files/{fileId}/download | Download one file |
GET | /v4/orders/{orderId}/files/download-all | Download all files as ZIP |
GET | /v4/files/download?token= | Anonymous download via webhook token |
GET | /v4/endpoints | Discover the operations your client may call |
All endpoints except /v4/auth/token and token-based file download require authentication.