# BreadPay Foundations API

**Canonical:** https://apis.io/apis/bread-financial/foundations-api/  
**Provider:** Bread Financial — https://apis.io/providers/bread-financial/  
**Base URL:** https://api.platform.breadpayments.com  
**Documentation:** https://platform-docs.breadpayments.com/bread-developers/reference/foundations-introduction

BreadPay Foundations API is one of 13 APIs that [Bread Financial](https://apis.io/providers/bread-financial/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Authentication, OAuth, Tokens, and Verification Codes. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

Platform foundations — service-account authorization (HTTP Basic client credentials exchanged for a bearer JWT), buyer login and token refresh, org-token exchange, one-time verification codes, org codes, and the common models shared across every other domain. 15 operations.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/auth/send-code` | Send a Verification OTP Code |
| GET | `/api/auth/code` | List codes |
| GET | `/api/auth/code/{referenceID}/status` | Get the status of a Verification OTP Code |
| POST | `/api/auth/buyer/verify-code` | Verify an OTP Code |
| POST | `/api/auth/buyer/authorize` | Authorize a buyer based on buyer credentials |
| POST | `/api/auth/login` | Login with an OTP Code |
| POST | `/api/auth/buyer/token/refresh` | Refresh a Buyer JWT |
| POST | `/api/auth/org/token/exchange` | Exchange Org User Token |
| POST | `/api/auth/service/authorize` | Authorize a Service Account |
| POST | `/api/auth/buyer/token/exchange` | Exchange Service Account JWT For Buyer JWT |
| POST | `/api/auth/org/code` | Create Org Codes |
| GET | `/api/auth/org/code` | Get Org Codes |
| POST | `/api/auth/org/authorize` | Authorize Org Code |
| POST | `/api/auth/org/code/expire` | Expire Org Codes |
| GET | `/api/auth/identity` | Get App Identities |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bread-financial/refs/heads/main/openapi/bread-foundations-openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/bread-financial/refs/heads/main/overlays/bread-foundations-overlay.yaml
- **Authentication** — https://platform-docs.breadpayments.com/bread-developers/docs/api-access

## Other Bread Financial APIs (12)

- [BreadPay Platform API](https://apis.io/apis/bread-financial/breadpay-platform-api/)
- [Bread Pay API](https://apis.io/apis/bread-financial/bread-pay-api/)
- [Bread SplitPay API](https://apis.io/apis/bread-financial/split-pay-api/)
- [BreadPay Checkout API](https://apis.io/apis/bread-financial/bread-pay-api/)
- [Bread SplitPay](https://apis.io/apis/bread-financial/split-pay-api/)
- [BreadPay Merchant Operations API](https://apis.io/apis/bread-financial/merchant-operations-api/)
- [BreadPay Servicing API](https://apis.io/apis/bread-financial/servicing-api/)
- [BreadPay Buyer Management API](https://apis.io/apis/bread-financial/buyer-management-api/)
- [BreadPay Payments API](https://apis.io/apis/bread-financial/payments-api/)
- [BreadPay Webhook API](https://apis.io/apis/bread-financial/webhook-api/)
- [BreadPay Program API](https://apis.io/apis/bread-financial/program-api/)
- [BreadPay Tradein API](https://apis.io/apis/bread-financial/tradein-api/)

## Tags

Authentication, OAuth, Tokens, Verification Codes

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/bread-financial/foundations-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/bread-financial/.