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

# Go Quickstart

> Install the Paxos Go SDK and list profiles in the Sandbox.

> [!NOTE]
>
> Beta: we aim to avoid breaking changes, but they may occur before 1.0.

This quickstart installs the Paxos Go SDK and lists the profiles on your Sandbox account. It takes about five minutes.

## ➊ Prerequisites

* Go 1.26 or later.
* A Paxos [Sandbox account](https://docs.paxos.com/guides/developer/account.md).

## ➋ Install

```shell theme={"theme":{"light":"github-light","dark":"github-dark"}}
mkdir paxos-quickstart && cd paxos-quickstart
go mod init paxos-quickstart
go get github.com/paxosglobal/paxos-sdk-go
```

## ➌ Set up credentials

Create Sandbox API credentials with the `funding:read_profile` scope. See [Configure API Credentials](https://docs.paxos.com/guides/developer/credentials.md).

```shell theme={"theme":{"light":"github-light","dark":"github-dark"}}
export PAXOS_CLIENT_ID="your_client_id"
export PAXOS_CLIENT_SECRET="your_client_secret"
```

Scopes are required when you construct a client. This quickstart requests `funding:read_profile`, which lets the client list profiles.

## ➍ List your profiles

Save the following as `main.go`:

```go theme={"theme":{"light":"github-light","dark":"github-dark"}}
package main

import (
	"context"
	"fmt"
	"log"
	"os"

	paxos "github.com/paxosglobal/paxos-sdk-go"
)

func main() {
	client, err := paxos.NewClient(
		os.Getenv("PAXOS_CLIENT_ID"),
		os.Getenv("PAXOS_CLIENT_SECRET"),
		paxos.WithSandbox(),
		paxos.WithScopes(paxos.ScopeFundingReadProfile),
	)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}

	iter := client.Profiles.ListProfiles(context.Background(), nil)
	for iter.Next() {
		profile := iter.Current()
		fmt.Printf("Profile: %s (%s)\n", profile.ID, profile.Nickname)
	}
	if err := iter.Err(); err != nil {
		log.Fatalf("failed to list profiles: %v", err)
	}
}
```

Run it:

```shell theme={"theme":{"light":"github-light","dark":"github-dark"}}
go run main.go
```

The output lists each profile's ID and nickname. `ListProfiles` returns an iterator that fetches additional pages automatically. Always check `iter.Err()` after the loop.

If a call fails, include the `request_id` when you contact Support.

## Next steps

* Read [Authentication](https://docs.paxos.com/sdks/authentication.md) to learn how credentials and scopes work.
* Explore the [Sandbox](https://docs.paxos.com/guides/developer/sandbox.md) to fund test profiles and simulate flows.
* Browse the [API Reference](https://docs.paxos.com/api-reference) for the endpoints available on each service.

> Questions? Contact [Support](https://support.paxos.com).
