> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.erp.olist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Informações da Conta

> Obtenha informações detalhadas da sua conta no sistema Olist ERP

<Warning>
  A API v2 não recebe mais atualizações ou novos recursos. Considere migrar para a [API v3](/documentacao/comecando/criando-um-aplicativo).
</Warning>

## Endpoint

```
POST https://api.tiny.com.br/api2/info.php
```

Serviço destinado a obter informações da conta, incluindo dados cadastrais da empresa.

## Parâmetros

| Parâmetro | Tipo   | Ocorrência  | Descrição                                 |
| --------- | ------ | ----------- | ----------------------------------------- |
| token     | string | obrigatório | Chave gerada para identificar sua empresa |
| formato   | string | obrigatório | Formato do retorno. Use `json`            |

## Retorno

| Campo                         | Tipo   | Tamanho | Ocorrência  | Descrição                                 |
| ----------------------------- | ------ | ------- | ----------- | ----------------------------------------- |
| retorno                       | object | -       | obrigatório | Elemento raiz do retorno                  |
| retorno.status\_processamento | int    | -       | obrigatório | Código de status do processamento         |
| retorno.status                | string | -       | obrigatório | "OK" ou "Erro"                            |
| retorno.codigo\_erro          | int    | -       | condicional | Código do erro conforme tabela da API (1) |
| retorno.erros                 | array  | -       | condicional | Lista de erros ocorridos (1)              |
| retorno.conta                 | object | -       | condicional | Informações da conta (2)                  |
| conta.razao\_social           | string | 80      | obrigatório | Razão social da empresa                   |
| conta.cnpj\_cpf               | string | 20      | obrigatório | CNPJ ou CPF                               |
| conta.fantasia                | string | 60      | opcional    | Nome fantasia                             |
| conta.endereco                | string | 60      | opcional    | Endereço                                  |
| conta.numero                  | string | 10      | opcional    | Número                                    |
| conta.bairro                  | string | 30      | opcional    | Bairro                                    |
| conta.complemento             | string | 60      | opcional    | Complemento                               |
| conta.cidade                  | string | 30      | opcional    | Cidade                                    |
| conta.estado                  | string | 2       | opcional    | UF do estado                              |
| conta.cep                     | string | 10      | opcional    | CEP                                       |
| conta.fone                    | string | 40      | opcional    | Telefone                                  |
| conta.email                   | string | 50      | opcional    | E-mail                                    |
| conta.inscricao\_estadual     | string | 18      | opcional    | Inscrição estadual                        |
| conta.regime\_tributario      | string | 56      | opcional    | Regime tributário                         |

> (1) Retornado quando status = "Erro"
>
> (2) Retornado quando status = "OK"

## Exemplo de chamada

```bash theme={null}
curl -X POST https://api.tiny.com.br/api2/info.php \
  -d "token=SEU_TOKEN&formato=json"
```

## Exemplo de retorno

### Sucesso

```json theme={null}
{
  "retorno": {
    "status_processamento": 3,
    "status": "OK",
    "conta": {
      "razao_social": "Empresa Exemplo LTDA",
      "cnpj_cpf": "12.345.678/0001-90",
      "fantasia": "Exemplo",
      "endereco": "Rua Exemplo",
      "numero": "123",
      "bairro": "Centro",
      "cidade": "São Paulo",
      "estado": "SP",
      "cep": "01234-567",
      "fone": "(11) 1234-5678",
      "email": "contato@exemplo.com.br",
      "inscricao_estadual": "123.456.789.012",
      "regime_tributario": "Simples Nacional"
    }
  }
}
```

### Erro - Token inválido

```json theme={null}
{
  "retorno": {
    "status_processamento": 3,
    "status": "Erro",
    "codigo_erro": 1,
    "erros": [
      {
        "erro": "Token informado é inválido"
      }
    ]
  }
}
```