GET
Empresa do contexto

Authorizations

Authorization
string
header
required

HTTP Basic com o token como usuário e o secret como senha: curl -u dpz_tk_…:dpz_sk_…. Crie a chave em https://despezzas.com/settings/api-keys.

Response

Sucesso.

Empresa como a API a devolve: a linha (sem dados de cobrança), o nome do espaço, o papel do usuário e a licença.

id
string
required

Id da empresa.

Example:

"9c7e5f31-2a4b-4d8c-b6e1-3f5a7c9e1b2d"

license
object
required

Situação da licença Business da empresa.

license_status
enum<string>
required

Status da licença.

Available options:
inactive,
manual,
trialing,
active,
past_due,
canceled,
expired
Example:

"active"

name
string
required

Nome do espaço (nome fantasia ou razão social).

Example:

"Loja Exemplo"

owner_user_id
string
required

Dono.

Example:

"0d6b923c-3392-424e-a152-2ee32474e8d5"

plan_key
enum<string>
required

Plano.

Available options:
solo,
team
Example:

"team"

profile_access_id
string
required

Perfil de Acesso interno da empresa (é o profile_id dos lançamentos).

Example:

"5b2c1e0a-7d3f-4c8e-9a1b-2f6d8e4c7a90"

razao_social
string
required

Razão social.

Example:

"Loja Exemplo LTDA"

role
enum<string>
required

Papel do usuário na empresa.

Available options:
owner,
editor,
viewer,
accountant
Example:

"owner"

address_city
string | null

Cidade.

Example:

"São Paulo"

address_complement
string | null

Complemento.

Example:

null

address_district
string | null

Bairro.

Example:

"Centro"

address_number
string | null

Número.

Example:

"120"

address_state
string | null

UF.

Example:

"SP"

address_street
string | null

Logradouro.

Example:

"Rua das Flores"

address_zip
string | null

CEP (só dígitos).

Example:

"01001000"

billing_email
string | null

E-mail de cobrança.

Example:

"financeiro@lojaexemplo.com.br"

cnae
string | null

CNAE principal.

Example:

"4781400"

cnpj
string | null

CNPJ (só dígitos).

Example:

"11222333000181"

createdAt
string<date-time>

Criação.

Example:

"2026-09-01T09:00:00.000Z"

income_value
integer | null

Faturamento mensal informado. Em centavos.

Example:

4500000

license_activated_at
string<date-time> | null

Ativação da licença.

Example:

"2026-09-01T09:00:00.000Z"

license_expires_at
string<date-time> | null

Expiração da licença.

Example:

null

license_source
enum<string> | null

Origem da licença.

Available options:
manual,
stripe,
null
Example:

"stripe"

mobile_phone
string | null

Celular.

Example:

"11999998888"

nome_fantasia
string | null

Nome fantasia.

Example:

"Loja Exemplo"

regime_tributario
enum<string> | null

Regime tributário.

Available options:
mei,
simples,
presumido,
real,
null
Example:

"simples"

seats_extra
integer

Assentos extras.

Example:

0

seats_included
integer

Assentos incluídos.

Example:

3

tax_reminder_day
integer | null

Dia do lembrete de impostos.

Example:

20

updatedAt
string<date-time>

Última alteração.

Example:

"2026-09-15T14:32:10.000Z"