---
title: "codespar boletos"
description: "DDA boletos: subscribe a document, list the boletos it receives"
---

DDA boletos: subscribe a document, list the boletos it receives

4 commands in `@codespar/cli 0.16.0`.

Each one prints what its operation answered. [What a command prints](/docs/cli/reference#what-a-command-prints) has the rule, and [Configuration](/docs/cli/config#what-a-script-gets-when-a-command-fails) has the exit codes and the shape of a failure.

### `codespar boletos get-subscriptions`

Read a DDA registration

```bash
codespar boletos get-subscriptions csm_0000000000000000 string
```

| argument | what it is |
|---|---|
| `<consumerId>` | String. |
| `<document>` | CPF or CNPJ. Punctuation is accepted and stripped. |

| option | what it does |
|---|---|
| `-q, --query <key=value>` | Query parameter (repeatable) (default: []) |
| `--timeout <ms>` | Per-request timeout in milliseconds |

`GET /v1/consumers/{consumerId}/dda/subscriptions/{document}` · [parameters, responses and refusals](/docs/api/reference/dda#get-v1consumersconsumeridddasubscriptionsdocument)

### `codespar boletos delete-subscriptions`

End a DDA registration

```bash
codespar boletos delete-subscriptions csm_0000000000000000 string
```

| argument | what it is |
|---|---|
| `<consumerId>` | String. |
| `<document>` | CPF or CNPJ. Punctuation is accepted and stripped. |

| option | what it does |
|---|---|
| `-q, --query <key=value>` | Query parameter (repeatable) (default: []) |
| `--timeout <ms>` | Per-request timeout in milliseconds |

`DELETE /v1/consumers/{consumerId}/dda/subscriptions/{document}` · [parameters, responses and refusals](/docs/api/reference/dda#delete-v1consumersconsumeridddasubscriptionsdocument)

### `codespar boletos list`

The boletos DDA has mirrored for this consumer

```bash
codespar boletos list csm_0000000000000000
```

| argument | what it is |
|---|---|
| `<consumerId>` | String. |

| option | what it does |
|---|---|
| `-q, --query <key=value>` | Query parameter (repeatable) (default: []) |
| `--timeout <ms>` | Per-request timeout in milliseconds |

`GET /v1/consumers/{consumerId}/dda/boletos` · [parameters, responses and refusals](/docs/api/reference/dda#get-v1consumersconsumeridddaboletos)

### `codespar boletos create-subscriptions`

Register the consumer's CPF/CNPJ with DDA

```bash
codespar boletos create-subscriptions csm_0000000000000000 --input '{"document":"string","client_name":"Example","idempotency_key":"string"}'
```

| argument | what it is |
|---|---|
| `<consumerId>` | String. |

| option | what it does |
|---|---|
| `-q, --query <key=value>` | Query parameter (repeatable) (default: []) |
| `--timeout <ms>` | Per-request timeout in milliseconds |
| `-i, --input <json>` | Request body as a JSON string |
| `-f, --input-file <path>` | Request body from a JSON file |

`POST /v1/consumers/{consumerId}/dda/subscriptions` · [parameters, responses and refusals](/docs/api/reference/dda#post-v1consumersconsumeridddasubscriptions)