# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hostmgr.gitbook.io/desenvolvedores/api-reference/contas-servicos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.