---
title: "GET Single company"
method: GET
path: "/api/companies/reseller/{id}"
---

# GET Single company

`GET /api/companies/reseller/{id}`

## Request

- Base URL: `https://app.plugsign.com.br`
- URL: `https://app.plugsign.com.br/api/companies/reseller/{id}`
- Auth: API key in header `Authorization`

Com este endpoint, você pode **recuperar os dados de uma única subconta**, utilizando o seu **Id** como referência.

Disponível apenas para contas revendedoras (outras contas recebem `501`). Um id inexistente ou de uma subconta que não é sua responde `404`.

## Path parameters

- `id` integer, required

## Response `200`

200

- object
  - `data` object: Dados da subconta.
    - `id` integer: Identificador único da empresa.
    - `name` string: Nome curto da empresa.
    - `email` string: E-mail da empresa.
    - `phone` string: Telefone da empresa.
    - `cnpj` string: CNPJ da empresa.
    - `address` string: Endereço da empresa.
    - `payment_end` string: Fim de vigência da conta do administrador da subconta, ou string vazia.
    - `access` object: Token de API da subconta; null quando a subconta ainda não tem token.
      - `token` string: Token de API (337 caracteres).
    - `can_login` integer: 1 se a subconta pode acessar a plataforma, 0 se não (null quando nunca definido).
    - `limits` object[]: Limites personalizados da subconta.
      - `id` integer
      - `companie` integer: Id da subconta.
      - `type` string: disk, users, files, signer, whatsapp ou files_total.
      - `new_limit` integer: Valor do limite.
    - `mail_host` string: Host do servidor SMTP configurado para a empresa, ou null.
    - `mail_from` string: E-mail remetente utilizado nos envios da empresa, ou null.
    - `mail_username` string: Usuário do servidor SMTP configurado para a empresa, ou null.
    - `mail_encryption` string: Tipo de criptografia do servidor SMTP (ssl ou tsl), ou null.
    - `mail_port` integer: Porta do servidor SMTP configurado para a empresa, ou null.
    - `unlimited` integer: 1 quando nenhum limite personalizado é aplicado à subconta.
    - `company_name` string: Nome da empresa cadastrada.
    - `editablevalidate` integer: Tipo de validação padrão ao assinar (1 a 7).
    - `signer_month` integer: Limite mensal de assinaturas, ou null.
    - `webhook_header_name` string: Nome do header customizado dos webhooks, ou null.
    - `webhook_header_value` string: Valor do header customizado dos webhooks, ou null.
    - `reseller_login` integer: 1 quando a revendedora pode fazer login na subconta para suporte.

## Other responses

- `404`: Subconta inexistente ou não vinculada à sua revendedora
- `501`: Conta sem perfil de revendedora

## Changes

- **2026-11-03** `3db1513040ea`: 3 breaking, 13 info
  - the `data/access` response's property type changed from `string` to `object` for status `200`
  - the `data/can_login` response's property type changed from `string` to `integer` for status `200`
  - the `data/mail_port` response's property type changed from `string` to `integer` for status `200`
  - added the non-success response with the status `404`
  - …12 more

[Operation history](https://skmtc.dev/plugsign/apis/endpoints-manuais/changes/api/companies/reseller/:id/get.md)

---

[API](https://skmtc.dev/plugsign/apis/endpoints-manuais.md) - [All operations](https://skmtc.dev/plugsign/apis/endpoints-manuais/llms.txt) - [OpenAPI document](https://skmtc.dev/plugsign/apis/endpoints-manuais/revisions/3db1513040ea?raw)