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

# List test accounts

> The test accounts this key has made, newest first. Passwords are never shown again.

Scope: `create:test_accounts`, granted on request · MCP tool: `list_test_accounts`

The test accounts this key made, the newest 100, including ones that have ended. Another key's accounts aren't listed, even on the same account, and a password is only ever shown when an account is [created](https://catchbackcards.mintlify.site/partner-api/endpoints/create-test-account.md).

## Response

**accounts** `object[]`

Newest first.

**account**

**user\_id** `string`

**email** `string`

The login.

**username** `string | null`

**balance** `number | null`

The test balance left, in dollars.

**created\_at** `string`

**expires\_at** `string`

**active** `boolean`

`false` from its `expires_at`, or once it has been turned off.

## Errors

| Status | When |
| - | - |
| `403` | The key lacks `create:test_accounts` |
| `500` | We couldn't read the list. Retry with backoff |

```bash cURL theme={null}
curl https://catchbackcards.com/api/partner/v1/test-accounts \
  -H "Authorization: Bearer $CATCHBACK_KEY"
```

```json 200 theme={null}
{
  "accounts": [
    {
      "user_id": "3b0e…",
      "email": "acme-9f2c41ab@test.catchbackcards.com",
      "username": "swiftFalcon4821",
      "balance": 9875,
      "created_at": "2026-11-02T18:00:00.000+00:00",
      "expires_at": "2026-12-02T18:00:00.000+00:00",
      "active": true
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.