> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bm.cards/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

> Credentials, environments, and your first Brand API call

## Overview

The **Brand API** lets your systems issue wallet cards, update cardholder data, and integrate with Bambu programs. This portal replaces the legacy Swagger UI at `swagger-brand*.bm.cards`.

You will need credentials from your Bambu account team before calling the API.

## Environments

| Environment    | API base URL                                    | OAuth token URL                                            |
| -------------- | ----------------------------------------------- | ---------------------------------------------------------- |
| **Production** | `https://api.bambumeta.software/brands`         | `https://api-auth.bambumeta.software/oauth2/token`         |
| **Sandbox**    | `https://api-sandbox.bambumeta.software/brands` | `https://api-auth-sandbox.bambumeta.software/oauth2/token` |

Use sandbox for development and UAT. Production credentials do not work against sandbox hosts.

## What you receive from Bambu

| Item            | Purpose                             |
| --------------- | ----------------------------------- |
| `client_id`     | OAuth2 client identifier            |
| `client_secret` | OAuth2 client secret (keep private) |
| `brand_id`      | Your brand scope for all paths      |
| `program_id`    | Default program for wallet issuance |

## Quickstart

1. [Authenticate](/guides/authentication) to obtain a Bearer access token.
2. Issue a card with `POST /{brand_id}/programs/{program_id}/issue-wallet`. Send `person` and `passdata` in one request. You do not need a separate person-create call.
3. [Look up or update](/guides/unique-identifier) the card with `unique_id` matching your external member key.

**Batch operations:** to create or update [multiple cards at once](/guides/bulk-cards), use `issue-wallets` or `bulk-wallets`.

See the **API Reference** tab for partner-facing endpoints grouped by use case (wallet cards, activations, transactions, SMS, and more). OAuth setup is also linked at the bottom of API Reference.

## Support

Contact your Bambu account team for credentials, rate limits, and integration review.