SDKs - SODACARDS

We publish an official SDK for four languages. Each is generated from this API’s OpenAPI specification and regenerated whenever the API changes, so a client never drifts from the contract. Under the hood every SDK sends the same requests you see in the API reference — pick the one for your stack.

Every call is authenticated with an API key from the developer dashboard, prefixed sc_live_ (production) or sc_test_ (sandbox). Load it from an environment variable — never commit a key. The examples below read SODACARDS_API_KEY.

TypeScript

npm add @sodacards/sdk

import { Sodacards } from "@sodacards/sdk";

const sodacards = new Sodacards({ apiKeyAuth: process.env.SODACARDS_API_KEY });

const catalog = await sodacards.listCatalog();
console.log(catalog);

Published as an ES module. pnpm add, bun add and yarn add work too.

Python

pip install sodacards

import os
import sodacards

config = sodacards.Configuration(host="https://api.sodacards.com")
config.api_key["ApiKeyAuth"] = os.environ["SODACARDS_API_KEY"]
client = sodacards.DefaultApi(sodacards.ApiClient(config))

catalog = client.list_catalog()
print(catalog)

Requires Python 3.10 or newer.

Go

go get github.com/SODACARDS/sodacards-go

client := sodacards.NewAPIClient(sodacards.NewConfiguration())
auth := context.WithValue(context.Background(), sodacards.ContextAPIKeys,
    map[string]sodacards.APIKey{"ApiKeyAuth": {Key: os.Getenv("SODACARDS_API_KEY")}})

catalog, _, err := client.DefaultAPI.ListCatalog(auth).Execute()

PHP

composer require sodacards/sdk

$config = Sodacards\Configuration::getDefaultConfiguration()
    ->setApiKey('X-API-Key', getenv('SODACARDS_API_KEY'));
$client = new Sodacards\Api\DefaultApi(new GuzzleHttp\Client(), $config);

$catalog = $client->listCatalog();

Per-endpoint examples

Every endpoint in the API reference carries a ready-to-copy snippet in all four languages — placing an order, revealing codes, registering a webhook, and the rest. The SDKs also surface typed errors that mirror the machine error codes, so you branch on the same values the raw API returns.

⌘I