# The Giving Block

> The Giving Block is a crypto-native fundraising platform. Its Public API and
> embeddable donation widget let partners accept cryptocurrency, stock, and card
> donations on behalf of 1,000+ nonprofits, instantly converting crypto to cash so
> nonprofits never have to touch crypto.

Generated by the API Evangelist enrichment pipeline (method: generated) from the
provider's published documentation. The provider also publishes its own authoritative
index at https://docs.thegivingblock.com/llms.txt (which links the OpenAPI reference);
prefer that for the machine-readable spec.

## API

- Name: The Giving Block Public API (v1.0)
- Style: RESTful, JSON, resource-oriented URLs
- Production base URL: https://public-api.tgbwidget.com
- Sandbox base URL: https://public-api.sandbox.thegivingblock.com
- Auth: JWT bearer. POST /v1/login to obtain access + refresh tokens; POST /v1/refresh-tokens to renew.
- Errors: custom JSON envelope (errorMessage, errorType, errorCode, meta); requestId on every response.
- Webhooks: AES-256 encrypted donation/transaction notifications.

## Documentation

- Docs home: https://docs.thegivingblock.com/
- API reference: https://docs.thegivingblock.com/reference/getting-started-1
- Getting started: https://docs.thegivingblock.com/docs/getting-started
- Authentication flow: https://docs.thegivingblock.com/docs/authentication-flow
- Crypto donation flow: https://docs.thegivingblock.com/docs/crypto-donation-flow
- Stock donation flow: https://docs.thegivingblock.com/docs/stock-donation-flow
- Card donation flow: https://docs.thegivingblock.com/docs/card-donation-flow
- Embedded donation form: https://docs.thegivingblock.com/docs/embedded-donation-form
- Sandbox intro: https://docs.thegivingblock.com/docs/sandbox-intro
- Webhook notifications: https://docs.thegivingblock.com/docs/webhook-notifications
- Developer resources: https://thegivingblock.com/developer-resources/

## Operations

- Auth: login, refreshTokens
- Organizations: GetOrganizationsList, GetOrganizationById, UpdateOrganization, GetWidgetSnippet, GetWidgetUrl
- Currencies & rates: GetCurrencyListV1, GetCurrencyListV2, GetCryptoToUSDRate
- Crypto donations: CreateDepositAddress
- Stock donations: GetBrokersList, GetTickersList, GetTickerCost, CreateStockDonationPledge, SubmitStockDonation, SignStockDonation
- Card / fiat donations: CreateFiatDonationPledge, ChargeFiatDonationPledge
- Testing: CreateTestDonation
- Transactions: GetTransactionList, GetTransactionByUuid