> For the complete documentation index, see [llms.txt](https://coindisco.gitbook.io/coindisco/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coindisco.gitbook.io/coindisco/white-label-api/shared-resources.md).

# Shared resources

Buy and sell flows use the same discovery resources. Retrieve them before requesting quotes and filter them for the current user context.

## Active providers

```bash
curl 'https://api.coindisco.com/api/white-label/v1/active-providers/' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'
```

```json
[
  {
    "id": 5,
    "name": "Example Provider",
    "slug_name": "example-provider",
    "icon": "https://cdn.example.com/provider.png",
    "url_for_transaction_details": "https://provider.example/orders/",
    "url_for_support": "https://provider.example/support",
    "domain": "provider.example",
    "privacy": "https://provider.example/privacy",
    "terms": "https://provider.example/terms",
    "sell_available": true
  }
]
```

`sell_available` indicates provider-level sell support. Final availability still depends on the selected region, asset, network, currency, method, and amount.

## Regions

```bash
curl 'https://api.coindisco.com/api/white-label/v1/regions/' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'
```

```json
[
  {
    "id": 157,
    "kind": "country",
    "name": "Poland",
    "alpha2_code": "PL",
    "alpha3_code": "POL",
    "letter_id": "poland",
    "icon": "https://cdn.example.com/regions/PL.png",
    "parent_region": null,
    "child_exists": false,
    "states": []
  }
]
```

If `child_exists` is true, require the applicable state or province rather than submitting only the parent country.

## Payment methods

```bash
curl 'https://api.coindisco.com/api/white-label/v1/regions/157/payment-methods/?service_id=5' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'
```

```json
[
  {
    "id": 39,
    "letter_id": "debit_card",
    "code": "debit_card",
    "name": "Debit card",
    "icon": "https://cdn.example.com/payment-methods/debit-card.png",
    "sell_available": true
  }
]
```

Omit `service_id` to discover methods across all providers available to the widget.

## Fiat currencies

```bash
curl 'https://api.coindisco.com/api/white-label/v1/regions/157/currencies/?service_id=5' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'
```

```json
[
  {
    "id": 3,
    "name": "USD",
    "symbol": "$",
    "icon": "https://cdn.example.com/currencies/USD.png",
    "full_name": "United States Dollar"
  }
]
```

## Crypto assets and networks

```bash
curl 'https://api.coindisco.com/api/white-label/v1/cryptocurrency/?service_id=5' \
  --header 'Partner-Api-Key: pk_test_YOUR_PUBLIC_KEY'
```

```json
{
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "code": "btc",
      "letter_id": "bitcoin",
      "logo": "https://cdn.example.com/crypto/bitcoin.png",
      "issuer": null,
      "home_domain": null,
      "networks": [
        {
          "id": 1,
          "name": "Bitcoin",
          "code": "bitcoin",
          "protocol_standard": "native"
        }
      ]
    }
  ]
}
```

Follow `next` until it is `null`; do not assume that the first page is the complete catalog.