Skip to main content
A API v2 não recebe mais atualizações ou novos recursos. Considere migrar para a API v3.

​
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âmetroTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar sua empresa
formatostringobrigatórioFormato do retorno. Use json

​
Retorno

CampoTipoTamanhoOcorrênciaDescrição
retornoobject-obrigatórioElemento raiz do retorno
retorno.status_processamentoint-obrigatórioCódigo de status do processamento
retorno.statusstring-obrigatório”OK” ou “Erro”
retorno.codigo_erroint-condicionalCódigo do erro conforme tabela da API (1)
retorno.errosarray-condicionalLista de erros ocorridos (1)
retorno.contaobject-condicionalInformações da conta (2)
conta.razao_socialstring80obrigatórioRazão social da empresa
conta.cnpj_cpfstring20obrigatórioCNPJ ou CPF
conta.fantasiastring60opcionalNome fantasia
conta.enderecostring60opcionalEndereço
conta.numerostring10opcionalNúmero
conta.bairrostring30opcionalBairro
conta.complementostring60opcionalComplemento
conta.cidadestring30opcionalCidade
conta.estadostring2opcionalUF do estado
conta.cepstring10opcionalCEP
conta.fonestring40opcionalTelefone
conta.emailstring50opcionalE-mail
conta.inscricao_estadualstring18opcionalInscrição estadual
conta.regime_tributariostring56opcionalRegime tributário
(1) Retornado quando status = “Erro” (2) Retornado quando status = “OK”

​
Exemplo de chamada

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

​
Exemplo de retorno

​
Sucesso

{
  "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

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