> For the complete documentation index, see [llms.txt](https://hostmgr.gitbook.io/desenvolvedores/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hostmgr.gitbook.io/desenvolvedores/api-reference/contas-servicos.md).

# Contas/Serviços

### Listar todas as Contas/Serviços

## Listar Serviços/Contas

<mark style="color:blue;">`GET`</mark> `/servicos/listar`

Lista todos os serviços existentes na base de consulta.&#x20;

Filtros estão disponíveis

#### Query Parameters

| Name        | Type   | Description                                                                                                                               |
| ----------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| dominio     | String | filtra pelo domínio da conta/serviço                                                                                                      |
| id\_produto | Number | Filtra pelo id de um produto específico                                                                                                   |
| id\_cliente | Number | Filtra pelo id do cliente listando apenas os serviços de determinado cliente                                                              |
| status      | String | <p>Filtra pelo status do Serviço</p><p><br>S -> Ativo<br>N -> Suspenso</p><p>P -> Pendente</p><p>C -> Cancelado</p><p>F -> Finalizado</p> |
| registros   | Number | <p>Quantidade de registros a serem listados por consulta (pagina)<br><br>Se não informado, adota 20 por padrão</p>                        |
| pagina      | Number | <p>Página atual da consulta (registros listados em paginação)<br>padrão: 1</p>                                                            |

{% tabs %}
{% tab title="200: OK Retorna objeto com a lista de faturas" %}

```json
{
    "status": "sucesso",
    "dados": {
        "total_registros": 2,
        "paginas": 1,
        "pagina": 1,
        "mostrando": "Registros de 1 até 2",
        "clientes": [
            {
                "id_conta": "47",
                "id_cliente": "2",
                "id_servidor": "1",
                "id_pedido": "76",
                "id_produto": "3",
                "id_afiliado": "0",
                "dominio": "testedominio.com",
                "login": "testedom",
                "ip_dedicado": null,
                "sdns1": null,
                "sdns2": null,
                "sdns1_ip": null,
                "sdns2_ip": null,
                "status": "C",
                "valor": "-1.00",
                "valor_recorrente": "-1.00",
                "data_cadastro": "2017-05-02",
                "data_vencimento": "2017-06-02",
                "ciclo_pagamento": "1",
                "promocao": "0",
                "bloqueio": "N",
                "data_suspender": "0000-00-00",
                "notas": null
            },
            {
                "id_conta": "46",
                "id_cliente": "2",
                "id_servidor": "1",
                "id_pedido": "75",
                "id_produto": "3",
                "id_afiliado": "0",
                "dominio": "teste",
                "login": "teste4224",
                "ip_dedicado": null,
                "sdns1": null,
                "sdns2": null,
                "sdns1_ip": null,
                "sdns2_ip": null,
                "status": "C",
                "valor": "-1.00",
                "valor_recorrente": "-1.00",
                "data_cadastro": "2017-05-02",
                "data_vencimento": "2017-06-02",
                "ciclo_pagamento": "1",
                "promocao": "0",
                "bloqueio": "N",
                "data_suspender": "0000-00-00",
                "notas": null
            }
        ]
    }
}
```

{% endtab %}

{% tab title="404: Not Found Objeto contendo erro" %}

```json
{
    "status": "erro",
    "dados": "não há serviços cadastrados"
}
```

{% endtab %}
{% endtabs %}

### Busca um serviço determinado

## Busca dados de um serviço determinado

<mark style="color:blue;">`GET`</mark> `/servicos/listar/{ID}`

responsável por listar dados de uma conta/serviço.

#### Path Parameters

| Name                                 | Type   | Description         |
| ------------------------------------ | ------ | ------------------- |
| ID<mark style="color:red;">\*</mark> | Number | ID da conta/serviço |

{% tabs %}
{% tab title="200: OK retorna um Objeto com os dados do cliente" %}

```json
{
    "status": "sucesso",
    "dados": [
        {
            "id_conta": "10161",
            "id_cliente": "10161",
            "id_servidor": "0",
            "id_pedido": "0",
            "id_produto": "44",
            "id_afiliado": "0",
            "dominio": "PIZZARIA 6SKINAS                    ",
            "login": "VILA MARIA ALTA     ",
            "ip_dedicado": "",
            "sdns1": "",
            "sdns2": "",
            "sdns1_ip": "",
            "sdns2_ip": "",
            "status": "S",
            "valor": "166.00",
            "valor_recorrente": "166.00",
            "data_cadastro": "2020-03-31",
            "data_vencimento": "2020-08-15",
            "ciclo_pagamento": "1",
            "promocao": "0",
            "bloqueio": "",
            "data_suspender": null,
            "notas": ""
        }
    ]
}
```

{% endtab %}

{% tab title="404: Not Found Erro na consulta" %}

```json
{
    "status": "erro",
    "dados": "não há serviços cadastrados"
}
```

{% endtab %}
{% endtabs %}