Consultar Organizações

Este método permite listar todas as suas organizações.

A consulta de organizações exibe 50 itens por página, sendo necessário navegar entre as páginas para consultar outros resultados.

Endpoint

https://api.tomticket.com/v2.0/organization/list

Método HTTP

GET

Content Type

form-data

Autenticação

Authorization: Bearer {SEU-TOKEN-AQUI}

Parâmetros Query String

Os parâmetros Query String são enviadas diretamente na URL após o símbolo de "?" ao final do endpoint. Cada parâmetro e valor deve ser enviado com o nome dele e valor, separados pelo símbolo de "=", como por exemplo nomeParametro=ValorParametro. Para enviar mais de um parâmetro, deve separá-los, usando símbolo "&", como por exemplo nomeParametro1=ValorParametro1&nomeParametro2=ValorParametro2.

Chave	Descrição	Obrigatório	Valor Padrão	Tipo	Tamanho Máximo
`page`	Índice da página que deseja acessar. São exibidos 50 itens a cada página.	Não	1	Int	-
`column`	Coluna usada para ordenação dos resultados. Podem ser usadas as seguintes opções `name`, `email`, `creation_date`.	Não	name	String	20
`order`	Mode de ordenação das colunas, podendo ser modo crescente `ASC` ou descrescente `DESC`.	Não	ASC	String	4
`show_custom_fields`	Define se os campos personalizados do cadastro da organização serão exibidos. Os valores disponíveis são: `0 - Não exibir` `1 - Exibir`	Não	0	Int	-
`organization_mother_id`	Permite pesquisar organizações filiais por um identificador da organização matriz.	Não	-	String	512

Retorno

Descrição do retorno em JSON.

Coluna	Descrição da Coluna	Tipo
`error`	Informa se ocorreu um erro na operação. Se o retorno for false, então significa que a operação ocorreu com sucesso e não ocorreram problemas. Caso o retorno seja true, ocorreu um erro e será necessário verificar o campo mensagem para identificar o problema.	`Boolean`
`message`	Detalhes da operação, caso tenha ocorrido ou não um problema.	`String`
`success`	Retorna `true` caso a operação tenha sido concluída com sucesso.	`Boolean`
`size`	Total de itens encontrados.	`Int`
`pages`	Total de páginas disponíveis para consulta.	`Int`
`next_page`	Próxima página disponível para navegação. Retornará `NULL` caso não houver.	`Int`
`previous_page`	Página anterior para navegação. Retornará `NULL` caso não houver.	`Int`
`data`	Lista com os clientes cadastrados.	`Array`
`data` `id`	Identificador da organização.	`String`
`data` `name`	Nome da organização.	`String`
`data` `email`	Endereço de email da organização.	`String`
`data` `phone`	Telefone da organização.	`String`
`data` `monthly_ticket_quota`	Cota mensal de chamados que podem ser criados pela organização.	`Int`
`data` `allow_create_tickets`	Permissão para criar chamados.	`Boolean`
`data` `has_child`	Informa se esta organização possui organizações filiais.	`Boolean`
`data` `active`	Informa se esta organização está ativa.	`Boolean`
`data` `manager_permission`	Informa se o gerente da organização pode ver os chamados dos clientes de sua organização no painel do cliente.	`Boolean`
`data` `members_permission`	Iiformarse os membros da organização podem ver os chamados um dos outros no painel do cliente.	`Boolean`
`data` `organization_mother`	Dados organização da organização matriz, caso ele esteja vinculado em uma.	`Array`
`data` `organization_mother` `id`	Identificador da organização matriz.	`String`
`data` `organization_mother` `name`	Nome da organização matriz.	`String`
`data` `custom_fields`	Campos Personalizados usados no cadastro da organização.	`Array`
`data` `custom_fields` `id`	Identificador do campo personalizado.	`String`
`data` `custom_fields` `name`	Label do campo personalizado.	`String`
`data` `custom_fields` `value`	Valor atribuído ao campo personalizado.	`Mixed`

Código de Retorno

Descrição do código HTTP de retorno.

Código	Descrição
200	Operação realizada com sucesso.
401	Token ou valores enviados não autorizados para uso.
403	Recurso não disponível.
404	Recurso não encontrado.

Disponibilidade

Recurso Premium Recurso Enterprise

Base de Conhecimento TomTicket