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.


ChaveDescriçãoObrigatórioValor PadrãoTipoTamanho Máximo
pageÍndice da página que deseja acessar. São exibidos 50 itens a cada página.Não1Int-
columnColuna usada para ordenação dos resultados.
Podem ser usadas as seguintes opções name, email, creation_date.
NãonameString20
orderMode de ordenação das colunas, podendo ser modo crescente ASC ou descrescente DESC.NãoASCString4
show_custom_fieldsDefine 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ão0Int-
organization_mother_idPermite pesquisar organizações filiais por um identificador da organização matriz.Não-String512

Retorno

Descrição do retorno em JSON.

ColunaDescrição da ColunaTipo
errorInforma 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
messageDetalhes da operação, caso tenha ocorrido ou não um problema.String
successRetorna true caso a operação tenha sido concluída com sucesso.Boolean
sizeTotal de itens encontrados.Int
pagesTotal de páginas disponíveis para consulta.Int
next_pagePróxima página disponível para navegação. Retornará NULL caso não houver.Int
previous_pagePágina anterior para navegação. Retornará NULL caso não houver.Int
dataLista 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ódigoDescrição
200Operação realizada com sucesso.
401Token ou valores enviados não autorizados para uso.
403Recurso não disponível.
404Recurso não encontrado.

Disponibilidade

Recurso Premium Recurso Enterprise


Was this article helpful?  
We appreciate your review.