#Accounts

Un Account es tu organización: el cliente de Clarisfy (un despacho o una empresa) que administra los RFCs (Fiscal Entities). Tu API key está atada a un Account, así que estos endpoints operan siempre sobre el tuyo. En la API el recurso se llama /organization.

#El objeto Account

Campo	Tipo	Descripción
`id`	string	Identificador único del Account (`org_…`).
`name`	string	Nombre de la organización.
`contact_email`	string \| null	Correo de contacto.
`logo_url`	string \| null	URL del logo.
`timezone`	string	Zona horaria (p. ej. `America/Mexico_City`).

#Tu organización

GET/organization

Devuelve el Account al que pertenece tu API key.

curl https://api.clarisfy.com/api/v1/organization \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "id": "org_01jtvm3qbwfr8at3kbq72yaeb1",
  "name": "Babbage & Lovelace SC",
  "contact_email": "contacto@babbage.mx",
  "logo_url": null,
  "timezone": "America/Mexico_City"
}

#Actualiza tu organización

PATCH/organization

Actualiza el name, contact_email o logo_url. Cualquier campo omitido o null se preserva (no se borra).

#Cuerpo de la petición

Campo	Tipo	Descripción
`name`	string \| null	Nombre de la organización (2–200 caracteres).
`contact_email`	string \| null	Correo de contacto (válido).
`logo_url`	string \| null	URL del logo.

curl -X PATCH https://api.clarisfy.com/api/v1/organization \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe" \
  -H "Content-Type: application/json" \
  -d '{"name": "Babbage & Lovelace SC", "contact_email": "contacto@babbage.mx"}'

Devuelve el Account actualizado (mismo shape que GET /organization).

#Estadísticas del Account

GET/organization/stats

Conteos en vivo del Account, derivados de sus membresías, conexiones y CFDIs.

curl https://api.clarisfy.com/api/v1/organization/stats \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

Campo	Tipo	Descripción
`total_members`	integer	Personas con membresía activa en el Account.
`active_rfcs`	integer	RFCs (conexiones) activos.

{
  "total_members": 3,
  "active_rfcs": 2
}