Dar de baja a un cliente

curl --request POST \
  --url https://api.craqui.com/v1/clients/{id}/deactivate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "moving_away",
  "note": "Se muda a Punta del Este."
}
'

import requests

url = "https://api.craqui.com/v1/clients/{id}/deactivate"

payload = {
    "reason": "moving_away",
    "note": "Se muda a Punta del Este."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({reason: 'moving_away', note: 'Se muda a Punta del Este.'})
};

fetch('https://api.craqui.com/v1/clients/{id}/deactivate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.craqui.com/v1/clients/{id}/deactivate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'reason' => 'moving_away',
    'note' => 'Se muda a Punta del Este.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.craqui.com/v1/clients/{id}/deactivate"

	payload := strings.NewReader("{\n  \"reason\": \"moving_away\",\n  \"note\": \"Se muda a Punta del Este.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.craqui.com/v1/clients/{id}/deactivate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"reason\": \"moving_away\",\n  \"note\": \"Se muda a Punta del Este.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.craqui.com/v1/clients/{id}/deactivate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"reason\": \"moving_away\",\n  \"note\": \"Se muda a Punta del Este.\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "cli_01je0mdfx4f3gr5peqyzsj0v2g",
  "object": "client",
  "livemode": true,
  "first_name": "Camila",
  "last_name": "Núñez",
  "status": "inactive",
  "home_center_id": "ctr_01j16rq65fme4r990anbaxvxfq",
  "created_at": "2026-11-26T12:05:00-03:00",
  "updated_at": "2026-12-15T10:20:00-03:00",
  "email": "camila.nunez@example.com",
  "phone": null,
  "metadata": {}
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

{
  "type": "https://docs.craqui.com/errors/revoked_api_key",
  "title": "La clave fue revocada",
  "status": 401,
  "code": "revoked_api_key",
  "detail": "Crea una clave nueva en Configuración → Integraciones.",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc"
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

{
  "type": "https://docs.craqui.com/errors/sandbox_unavailable",
  "title": "Tu estudio de prueba no está listo",
  "status": 409,
  "code": "sandbox_unavailable",
  "detail": "Restablece tus datos de prueba en Configuración → Integraciones y vuelve a intentar.",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc"
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

clients

Dar de baja a un cliente

Da de baja a un cliente, igual que “Dar de baja” en su ficha de Craqui. Antes, da de baja en MercadoPago, confirmado, cada débito automático que le pueda estar cobrando; si MercadoPago no lo confirma, no se da de baja al cliente. Después, en un solo paso: cancela sus reservas fijas y sus reservas futuras (los créditos vuelven según las reglas de cada clase), cierra su membresía, da de baja sus cuotas futuras sin pagar y sus compras sin pagar de la web app, vence sus créditos y lo deja dado de baja. No devuelve plata: una cuota ya pagada sigue pagada y una cuota vencida sin pagar sigue siendo deuda. No le avisa nada al cliente. Responde el cliente como queda, con su ETag.

Si la membresía del cliente tiene un pago por adelantado sin cobrar, decide qué pasa con él (advance_payment_unpaid): la API no aplica ningún valor por defecto sobre plata. Si el cliente ya está dado de baja, responde 200 con el cliente y no cambia nada. Con dry_run=true responde 200 con la vista previa: qué cancelaría, cuántos débitos daría de baja y la deuda que queda.

Rechazos (409): advance_payment_choice_required (con amount_at_stake), client_has_automatic_debit, automatic_debit_not_cancellable y client_is_key_owner; 502 automatic_debit_cancel_failed (MercadoPago no confirmó: reintenta con la misma Idempotency-Key). Un cliente que no es de tu negocio responde 404 not_found.

Una escritura de plata: lleva Idempotency-Key (salvo con dry_run=true), solo para estudios (en una academia responde wrong_vertical), solo si tu negocio tiene habilitada la escritura por la API (write_access_disabled si no) y además las escrituras de plata (money_writes_not_enabled si no), aunque la clave tenga clients:write. Cuenta para el límite de escrituras (30 por minuto) y para el de escrituras de plata (10 por minuto; una vista previa no cuenta para este). Un campo que el cuerpo no declara responde validation_failed con unknown_field. Un reintento con la misma Idempotency-Key, también después de las 24 horas, responde lo que ya se hizo, con Idempotent-Replayed: true.

POST

clients

{id}

deactivate

Dar de baja a un cliente

curl --request POST \
  --url https://api.craqui.com/v1/clients/{id}/deactivate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "moving_away",
  "note": "Se muda a Punta del Este."
}
'

import requests

url = "https://api.craqui.com/v1/clients/{id}/deactivate"

payload = {
    "reason": "moving_away",
    "note": "Se muda a Punta del Este."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({reason: 'moving_away', note: 'Se muda a Punta del Este.'})
};

fetch('https://api.craqui.com/v1/clients/{id}/deactivate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.craqui.com/v1/clients/{id}/deactivate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'reason' => 'moving_away',
    'note' => 'Se muda a Punta del Este.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.craqui.com/v1/clients/{id}/deactivate"

	payload := strings.NewReader("{\n  \"reason\": \"moving_away\",\n  \"note\": \"Se muda a Punta del Este.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.craqui.com/v1/clients/{id}/deactivate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"reason\": \"moving_away\",\n  \"note\": \"Se muda a Punta del Este.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.craqui.com/v1/clients/{id}/deactivate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"reason\": \"moving_away\",\n  \"note\": \"Se muda a Punta del Este.\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "cli_01je0mdfx4f3gr5peqyzsj0v2g",
  "object": "client",
  "livemode": true,
  "first_name": "Camila",
  "last_name": "Núñez",
  "status": "inactive",
  "home_center_id": "ctr_01j16rq65fme4r990anbaxvxfq",
  "created_at": "2026-11-26T12:05:00-03:00",
  "updated_at": "2026-12-15T10:20:00-03:00",
  "email": "camila.nunez@example.com",
  "phone": null,
  "metadata": {}
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

{
  "type": "https://docs.craqui.com/errors/revoked_api_key",
  "title": "La clave fue revocada",
  "status": 401,
  "code": "revoked_api_key",
  "detail": "Crea una clave nueva en Configuración → Integraciones.",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc"
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

{
  "type": "https://docs.craqui.com/errors/sandbox_unavailable",
  "title": "Tu estudio de prueba no está listo",
  "status": 409,
  "code": "sandbox_unavailable",
  "detail": "Restablece tus datos de prueba en Configuración → Integraciones y vuelve a intentar.",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc"
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

{
  "type": "https://docs.craqui.com/errors/invalid_api_key",
  "title": "La clave no es válida",
  "status": 401,
  "code": "invalid_api_key",
  "request_id": "req_01hzx8m4k2a7d9q3f5w6y8z0bc",
  "detail": "Revisa que copiaste la clave completa, incluido el prefijo (crq_live_ o crq_test_).",
  "doc_url": "<string>",
  "required_scope": "business:read",
  "errors": [
    {
      "field": "limit",
      "code": "invalid_limit",
      "detail": "<string>"
    }
  ],
  "current_price": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "expected_amount": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "amount_at_stake": {
    "amount_cents": 250000,
    "currency": "UYU"
  },
  "existing_membership_id": "mem_01j1q27t44qvr6v2s50cv4rbvq",
  "booking_ids": [
    "bkg_01jx9eak0437zdf0yw0atg7g0r"
  ]
}

Authorizations

Authorization

string

header

required

Clave del negocio. sk es una clave completa (todo lo que el rol de quien la creó puede dar) y rk una restringida a los permisos que se eligieron al crearla. Solo se usa desde un servidor: un pedido desde un navegador se rechaza con browser_not_allowed.

Scopes

clients:write

Crear, cambiar, dar de baja y reactivar clientes.

Headers

Craqui-Version

string

Versión de la API para este pedido (YYYY-MM-DD). Si no la mandas, se usa la versión fijada en la clave cuando se creó.

Pattern: ^\d{4}-\d{2}-\d{2}$

Example:

"2026-12-01"

Idempotency-Key

string

Obligatorio en todo pedido que crea o cambia algo, salvo con dry_run=true. Un valor único por operación (por ejemplo un UUID). Si repites el pedido con la misma clave y el mismo cuerpo dentro de 24 horas, recibes la misma respuesta (con el header Idempotent-Replayed: true) sin que se repita el efecto, también la misma respuesta de error: para intentar de nuevo algo que se rechazó, usa una clave nueva. Con un dry_run=true la clave se ignora y no se guarda: el pedido real puede usar la misma. Pasadas las 24 horas, repetir una reserva con la misma clave y el mismo cuerpo sigue devolviendo la reserva que se hizo (como está ahora), y la misma clave con otro cuerpo responde idempotency_key_reused.

Required string length: 1 - 255

Path Parameters

string

required

El id del cliente (cli_…). Id de un cliente del estudio.

Pattern: ^cli_[0-7][0-9a-hjkmnp-tv-z]{25}$

Example:

"cli_01jatfha5h4nkg77c3wfrvd3cw"

Query Parameters

dry_run

boolean

true para ver qué pasaría sin hacerlo: Craqui evalúa el pedido con las mismas reglas que el real y responde 200 con un objeto preview, sin escribir nada ni avisarle a nadie. Cuenta para el límite de escrituras. false (o sin el parámetro) hace el pedido real. Es el único parámetro de consulta de una escritura.

Body

application/json

Lo mismo que pide el diálogo de baja de Craqui. Todos los campos son opcionales (el cuerpo puede faltar).

reason

enum<string> | null

Por qué se va, para los reportes del estudio.

Available options:

schedule_conflict,

financial,

not_enjoying,

moving_away,

health,

found_alternative,

other,

null

note

string | null

Una nota para el estudio. No la ve el cliente.

Maximum string length: 500

advance_payment_unpaid

enum<string> | null

Solo hace falta si la membresía del cliente tiene un pago por adelantado sin cobrar (si falta, responde 409 advance_payment_choice_required con amount_at_stake). prorate: se cobra solo lo que ya usó; keep: la cuota queda como está; retire: se da de baja la cuota.

Available options:

prorate,

keep,

retire,

null

Response

El cliente como quedó, o con dry_run=true la vista previa (object dice cuál).

Option 1
Option 2

Un cliente del estudio. Nunca trae fecha de nacimiento, dirección, documento, datos fiscales, de salud, notas ni contacto de emergencia.

Un cliente deleted (el estudio lo dio de baja) responde solo por id o dentro de un expand, porque una reserva o una cuota vieja sigue apuntando a su id: trae id, status y fechas, con first_name y last_name en null, y nunca email ni phone, con ningún permiso.

string

required

Id de un cliente del estudio.

Pattern: ^cli_[0-7][0-9a-hjkmnp-tv-z]{25}$

Example:

"cli_01jatfha5h4nkg77c3wfrvd3cw"

object

string

required

Allowed value: "client"

livemode

boolean

required

false si el objeto es de tu estudio de prueba (claves crq_test_); true con claves crq_live_.

first_name

string | null

required

null en un cliente deleted, o si el estudio no lo cargó.

Example:

"Sofía"

last_name

string | null

required

null en un cliente deleted, o si el estudio no lo cargó.

Example:

"Pérez"

status

enum<string>

required

active, inactive o deleted. Las listas traen solo active e inactive. La lista puede crecer: trata un valor que no conoces como inactivo.

Available options:

active,

inactive,

deleted

home_center_id

string | null

required

La sede habitual del cliente, si el estudio le asignó una.

Pattern: ^ctr_[0-7][0-9a-hjkmnp-tv-z]{25}$

Example:

"ctr_01j65pdnq74qvnh0953pzvtczg"

created_at

string<date-time>

required

Cuándo pasó a ser cliente de este estudio.

Example:

"2026-12-02T19:00:00-03:00"

updated_at

string<date-time>

required

La última vez que cambió algo del cliente, su metadata incluida.

Example:

"2026-12-02T19:00:00-03:00"

metadata

object

required

Lo que tu sistema guardó sobre el cliente ({} si nada). Un cliente deleted trae {}.

Show child attributes

string | null

Solo con el permiso clients.pii:read: sin él, el campo no viene (no es null). null si el cliente no tiene email.

phone

string | null

Solo con el permiso clients.pii:read: sin él, el campo no viene. En formato E.164 (+59899123456); null si no tiene teléfono o si no se pudo leer como uno.

Pattern: ^\+[1-9]\d{6,14}$

Example:

"+59899123456"

active_membership

object | null

Solo en GET /v1/clients/{id} con expand[]=active_membership (pide memberships:read): la membresía que tiene ahora (la active; si no hay, la más nueva paused, suspended o pending_payment). null si no tiene ninguna.

Show child attributes

credit_balance

object

Solo en GET /v1/clients/{id} con expand[]=credit_balance (pide credits:read).

Show child attributes

business

booking_policy

centers

rooms

teachers

courses

classes

credit_packs

membership_plans

intro_offers

sessions

clients

bookings

credits

memberships

fees

payments

refunds

events

webhook_endpoints

Dar de baja a un cliente

Authorizations

Scopes

Headers

Path Parameters

Query Parameters

Body

Response