# The Giving Block Public API Documentation

> Documentation for The Giving Block Public API

## Guides
- [✅ Get Started](https://docs.thegivingblock.com/docs/getting-started.md): Ready to begin your crypto, stock, or card integration with The Giving Block? Get started by following our integration checklist
- [🔐 Authentication Flow](https://docs.thegivingblock.com/docs/authentication-flow.md)
- [🚢 Nonprofit Onboarding Flow](https://docs.thegivingblock.com/docs/todo.md)
- [🌕 Crypto Donations](https://docs.thegivingblock.com/docs/crypto-donations-nonprofit-onboarding-flow.md): This flow should be used when you would like to build your own donation form or embed our donation form for crypto donations using our 501c3 partner
- [📈 Stock Donations](https://docs.thegivingblock.com/docs/stock-donations-nonprofit-onboarding-flow.md): This flow should be used when you would like to build your own donation form or embed our donation form with support for stock donations.
- [💳 Card Donations](https://docs.thegivingblock.com/docs/nonprofit-onboarding-flow-for-card-donations.md): This flow should be used when you would like to build direct integration with Shift4 payments API for the card payments
- [🌕 Crypto Donation Flow](https://docs.thegivingblock.com/docs/crypto-donation-flow.md): This page describes how to perform crypto donation using The Giving Block public API when you are building your native donation form
- [📈 Stock Donation Flow](https://docs.thegivingblock.com/docs/stock-donation-flow.md): This page describes how to perform stock donation using The Giving Block public API when you are building your native donation form
- [💳 Card Donation Flow](https://docs.thegivingblock.com/docs/card-donation-flow.md): This page describes how to perform card donation using The Giving Block public API when you are building your native donation form
- [🏠 Embedded donation form](https://docs.thegivingblock.com/docs/embedded-donation-form.md)
- [🛝 Sandbox Intro](https://docs.thegivingblock.com/docs/sandbox-intro.md)
- [👩‍💻 How to Make a Test Crypto Donation](https://docs.thegivingblock.com/docs/how-to-make-a-test-crypto-donation.md)
- [ 🐂 How to Make a Test Stock Donation](https://docs.thegivingblock.com/docs/how-to-make-a-test-stock-donation.md)
- [🏦 How to Make a Test DAF Donation](https://docs.thegivingblock.com/docs/how-to-make-a-test-daf-donation.md)
- [ 💳 How to Make a Test Card Donation](https://docs.thegivingblock.com/docs/how-to-make-a-test-card-donation.md)
- [🔔 Webhook notifications](https://docs.thegivingblock.com/docs/webhook-notifications.md): This section covers server-to-server communication that happens in case of some events
- [💥 API Brand Guidelines](https://docs.thegivingblock.com/docs/todo-2.md)

## API Reference
- [📒 General information](https://docs.thegivingblock.com/reference/getting-started-1.md)
- [🔐 Authentication](https://docs.thegivingblock.com/reference/authentication.md)
- [login](https://docs.thegivingblock.com/reference/post_v1-login-1.md): Exchanges username and password for an access token.
- [refreshTokens](https://docs.thegivingblock.com/reference/post_v1-refresh-tokens-1.md): This endpoint should be used to refresh a pair of Access and Refresh Tokens to avoid repetitive Login requests.
- [GetCurrencyListV1](https://docs.thegivingblock.com/reference/post_v1-currencies-list-1.md): [DEPRECATED] This endpoint is used to get the list of currencies based on the filters provided.
- [GetCurrencyListV2](https://docs.thegivingblock.com/reference/post_v2-currencies-list-1.md): This endpoint is used to get the list of currencies based on the filters provided.
- [CreateDepositAddress](https://docs.thegivingblock.com/reference/post_v1-deposit-address-1.md): This endpoint is used to create a crypto Deposit Address for Donation.
- [CreateTestDonation](https://docs.thegivingblock.com/reference/post_v1-test-donation-create.md): Creates a test donation
- [CreateStockDonationPledge](https://docs.thegivingblock.com/reference/post_v1-donation-stocks-1.md): Creates a pledge for Stock donation. pledgeAmount is amount of shares that donor donates and assetSymbol along with assetDescription defines what share it is.
- [CreateFiatDonationPledge](https://docs.thegivingblock.com/reference/post_v1-donation-fiat-1.md): This endpoint is used to create a fiat donation.
- [ChargeFiatDonationPledge](https://docs.thegivingblock.com/reference/post_v1-donation-fiat-charge-1.md): This endpoint is used to charge a card.
- [GetCryptoToUSDRate](https://docs.thegivingblock.com/reference/get_v1-crypto-to-usd-rate-1.md): Get exchange rate for crypto currency to USD
- [NonProfitOnboarding](https://docs.thegivingblock.com/reference/post_v1-non-profit-onboarding-1.md): Non-profit organization onboarding initiation
- [NonProfitCryptoOnboarding](https://docs.thegivingblock.com/reference/post_v1-non-profit-onboarding-organizationid-crypto-1.md): Non-profit organization crypto onboarding
- [NonProfitCardOnboarding](https://docs.thegivingblock.com/reference/post_v1-non-profit-onboarding-organizationid-card-1.md): Non-profit organization card onboarding
- [NonProfitStockOnboarding](https://docs.thegivingblock.com/reference/post_v1-non-profit-onboarding-organizationid-stock-1.md): Non-profit organization stock onboarding
- [GetOrganizationsList](https://docs.thegivingblock.com/reference/get_v1-organizations-list-1.md): This endpoint should be used to retrieve a list of available nonprofits. This list is used to display a list of Organizations so users can choose one of them for donation.
- [GetTotalRaisedStats](https://docs.thegivingblock.com/reference/post_v1-organizations-total-raised-1.md): Get financial statistics for organizations.
- [GetOrganizationById](https://docs.thegivingblock.com/reference/get_v1-organization-id-1.md): This endpoint should be used to retrieve nonprofit by id. This response is used to display details on the organization page.
- [UpdateOrganization](https://docs.thegivingblock.com/reference/put_v1-organization-id-1.md): This endpoint should be used to update nonprofit parameters by id.
- [GetWidgetSnippet](https://docs.thegivingblock.com/reference/post_v1-organization-id-widget-snippet-1.md): Generate code snippets for the widget.
- [GetWidgetUrl](https://docs.thegivingblock.com/reference/post_v1-organization-id-widget-url-1.md): Provides endpoint by which partners are able to get URL to Donation Form where donor will finalize payment/donation.
- [GetBrokersList](https://docs.thegivingblock.com/reference/get_v1-stocks-brokers-1.md): Get list of supported brokers
- [GetTickersList](https://docs.thegivingblock.com/reference/post_v1-stocks-tickers-1.md): Get list of available stock tickers
- [GetTickerCost](https://docs.thegivingblock.com/reference/get_v1-stocks-ticker-cost-1.md): Get close price for a ticker
- [SubmitStockDonation](https://docs.thegivingblock.com/reference/post_v1-stocks-submit-1.md): Submit donor-specified stock donation information for a pledge
- [SignStockDonation](https://docs.thegivingblock.com/reference/post_v1-stocks-sign-1.md): Submit a signature to authenticate all donor-specified data for a stock donation pledge
- [GetTransactionList](https://docs.thegivingblock.com/reference/post_v1-transaction-list-1.md): This endpoint is used to get the list of transactions based on the filters provided.
- [GetTransactionByUuid](https://docs.thegivingblock.com/reference/get_v1-transaction-uuid-1.md): This endpoint is used to get the transaction by its UUID.

## Pages
- [Test custom page](https://docs.thegivingblock.com/test-custom-page.md)