---
title: "List card designs"
description: "List the card designs validated by Charitips."
canonical: https://www.charitips.com/docs/api-reference/list-card-designs
---

# List card designs

`GET /v1/card-designs`

List the card designs validated by Charitips. Set one as the momentSlug of a campaign: its cards, printed and posted on POSTAL campaigns, take that design.

**Authentication**: Bearer access token.

## Parameters

- `language` (string): Language of the card previews. One of `fr`, `en`.

## Response 200

- `momentSlug` (string, required): Value to set as the campaign momentSlug. Null for the Charitips card, the default.
- `accentColor` (string, required): Accent colour of the card, #rrggbb. Null for the Charitips card.
- `previewUrl` (string, required): Front of the card, without amount.

## Errors

- 400 `A field is missing, has the wrong type, or is not part of the request schema.`: `message` lists every problem. Unknown fields are rejected, not ignored: remove them rather than sending extra data. See https://www.charitips.com/docs/api-reference/errors.md.
- 401 `Unauthorized`: The access token is missing, expired or invalid. Create a new one with your client id and secret, send it as `Authorization: Bearer <accessToken>`, then retry once. Sandbox tokens only work on api.sandbox.charitips.com. See https://www.charitips.com/docs/get-started/authentication.md.
- 403 `Account closed`: The account behind these credentials is closed: no token is issued and every call is refused, reads included. Contact Charitips to reopen it. See https://www.charitips.com/docs/api-reference/troubleshooting.md#calls-answer-403-account-not-active-account-not-validated-or-account-closed.

## Example

```bash
curl -X GET https://api.sandbox.charitips.com/v1/card-designs \
  -H "Authorization: Bearer $CHARITIPS_TOKEN"
```

```javascript
const response = await fetch('https://api.sandbox.charitips.com/v1/card-designs', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CHARITIPS_TOKEN}`,
  },
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();
```

```python
import os, requests

response = requests.get(
    "https://api.sandbox.charitips.com/v1/card-designs",
    headers={"Authorization": f"Bearer {os.environ['CHARITIPS_TOKEN']}"},
)
response.raise_for_status()
data = response.json()
```

## Response example (200, placeholder values)

```json
[
  {
    "momentSlug": "<momentSlug>",
    "accentColor": "<accentColor>",
    "previewUrl": "<previewUrl>"
  }
]
```